@siliconuy/gist-mcp v1.0.0

Gist MCP Server

Servidor MCP para interactuar con GitHub Gists. Este paquete proporciona una integración entre el Model Context Protocol (MCP) y la API de Gists de GitHub.

Instalación

npm install -g @siliconuy/gist-mcp

Uso

Configuración

1. Crea un token de GitHub con permisos gist en https://github.com/settings/tokens

2. Configura el token en el archivo de configuración MCP:

{
  "mcpServers": {
    "gist": {
      "command": "npx",
      "args": ["@siliconuy/gist-mcp"],
      "env": {
        "GITHUB_TOKEN": "tu-token-aquí"
      }
    }
  }
}

Herramientas Disponibles

create_gist

Crear un nuevo gist

{
  description?: string;
  files: Record<string, { content: string }>;
  public?: boolean;
}

get_gist

Obtener un gist por ID

{
  gistId: string;
}

update_gist

Actualizar un gist existente

{
  gistId: string;
  description?: string;
  files?: Record<string, { content: string } | null>;
}

delete_gist

Eliminar un gist

{
  gistId: string;
}

list_gists

Listar gists del usuario

{
  username?: string;
  per_page?: number;
  page?: number;
}

Ejemplos

Crear un Gist

const result = await useMcpTool('gist', 'create_gist', {
  description: 'Mi primer gist',
  files: {
    'hello.txt': {
      content: '¡Hola, mundo!'
    }
  },
  public: false
});

Obtener un Gist

const result = await useMcpTool('gist', 'get_gist', {
  gistId: 'abc123'
});

Listar Gists

const result = await useMcpTool('gist', 'list_gists', {
  username: 'siliconuy',
  per_page: 10
});

Desarrollo

1. Clonar el repositorio

git clone https://github.com/siliconuy/gist-mcp.git
cd gist-mcp

2. Instalar dependencias

npm install

3. Compilar

npm run build

Licencia

MIT