Erick Wendel Contributions MCP

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Integrates with a GraphQL API at tml-api.herokuapp.com to fetch data about Erick Wendel's talks, posts, and videos with filtering capabilities

  • Connects to a GraphQL API hosted on Heroku to fetch and filter Erick Wendel's contributions data

  • Runs natively in Node.js environment without transpilation, providing tools for querying Erick Wendel's content

contribuciones de erickwendel-mcp

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para consultar las contribuciones de Erick Wendel en diferentes plataformas. Consulta charlas, entradas de blog y vídeos en lenguaje natural mediante Claude, Cursor o similares. Este proyecto se desarrolló utilizando Cursor IDE con el agente predeterminado (versión de prueba).

Este servidor MCP también está disponible en Smithery para integración directa.

Herramientas disponibles

Este servidor MCP proporciona las siguientes herramientas para interactuar con la API:

  • get-talks : recupera una lista paginada de conversaciones con filtrado opcional
    • Admite filtrado por ID, título, idioma, ciudad, país y año.
    • Puede devolver recuentos agrupados por idioma, país o ciudad.
  • get-posts : obtiene publicaciones con filtrado y paginación opcionales
    • Admite filtrado por ID, título, idioma y portal.
  • get-videos : recupera vídeos con filtrado y paginación opcionales
    • Admite filtrado por ID, título e idioma.
  • check-status : verifica si la API está activa y responde

Integración con herramientas de IA

Inspeccionar las capacidades del servidor MCP

Puede inspeccionar las capacidades de este servidor MCP usando Smithery:

npx -y @smithery/cli@latest inspect @ErickWendel/erickwendel-contributions-mcp

Esto le mostrará todas las herramientas disponibles, sus parámetros y cómo usarlas.

Configuración

  1. Asegúrate de estar usando Node.js v23+
node -v #v23.9.0
  1. Clonar este repositorio:
git clone https://github.com/erickwendel/erickwendel-contributions-mcp.git cd erickwendel-contributions-mcp
  1. Restaurar dependencias:
npm ci

Integración con herramientas de IA

Configuración del cursor

  1. Abrir configuración del cursor
  2. Navegar a la sección MCP
  3. Haga clic en "Agregar nuevo servidor MCP"
  4. Configurar el servidor:
    Name = erickwendel-contributions Type = command Command = node ABSOLUTE_PATH_TO_PROJECT/src/index.ts
    o si prefieres ejecutarlo desde Smithery
    Name = erickwendel-contributions Type = command Command = npm exec -- @smithery/cli@latest run @ErickWendel/erickwendel-contributions-mcp

o configure directamente desde el archivo MCP global del Cursor ubicado en ~/.cursor/mcp.json y agregue lo siguiente:

{ "mcpServers": { "erickwendel-contributions": { "command": "node", "args": ["ABSOLUTE_PATH_TO_PROJECT/src/index.ts"] } } }

o si prefieres ejecutarlo desde Smithery

{ "mcpServers": { "erickwendel-contributions": { "command": "npm", "args": [ "exec", "--", "@smithery/cli@latest", "run", "@ErickWendel/erickwendel-contributions-mcp" ] } } }
  1. Asegúrese de que el chat del cursor esté en modo Agente seleccionando "Agente" en el menú desplegable de la parte inferior izquierda
  2. Ve al chat y pregunta "¿cuántos vídeos se publicaron sobre JavaScript en 2024?"

Configuración del escritorio de Claude

Instalación mediante herrería

Para instalar Erick Wendel Contributions para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @ErickWendel/erickwendel-contributions-mcp --client claude

Nota : La instalación de Smithery CLI para Claude presenta problemas. Utilice el método de instalación manual a continuación hasta que se resuelva.

Configuración manual

  1. Ir a la configuración de Claude
  2. Haga clic en la pestaña Desarrollador
  3. Haga clic en editar configuración
  4. Abra la configuración en un editor de código
  5. Agregue la siguiente configuración a su configuración de Claude Desktop:
{ "mcpServers": { "erickwendel-contributions": { "command": "node", "args": ["ABSOLUTE_PATH_TO_PROJECT/src/index.ts"] } } }

o si prefieres ejecutarlo desde Smithery

{ "mcpServers": { "erickwendel-contributions": { "command": "npm", "args": [ "exec", "--", "@smithery/cli@latest", "run", "@ErickWendel/erickwendel-contributions-mcp" ] } } }
  1. Guardar archivo y reiniciar Claude Desktop
  2. Abra nuevamente la pestaña Desarrollador y verifique si está en estado "en ejecución" de la siguiente manera:

  1. Ve al chat y pregunta "¿Hay videos sobre RAG?"

Alternativa gratuita a MCPHost

Si no tiene acceso a Claude Desktop ni a Cursor, puede usar MCPHost con Ollama como alternativa gratuita. MCPHost es una herramienta CLI que permite que los modelos de lenguaje grandes interactúen con servidores MCP.

  1. Instalar MCPHost:
go install github.com/mark3labs/mcphost@latest
  1. Cree un archivo de configuración (por ejemplo , ./mcp.jsonc ):
{ "mcpServers": { "erickwendel-contributions": { "command": "node", "args": ["ABSOLUTE_PATH_TO_PROJECT/src/index.ts"] } } }

o si prefieres ejecutarlo desde Smithery

{ "mcpServers": { "erickwendel-contributions": { "command": "npm", "args": [ "exec", "--", "@smithery/cli@latest", "run", "@ErickWendel/erickwendel-contributions-mcp" ] } } }
  1. Ejecute MCPHost con su modelo Ollama preferido:
ollama pull MODEL_NAME mcphost --config ./mcp.jsonc -m ollama:MODEL_NAME

Consultas de ejemplo

A continuación se muestran algunos ejemplos de consultas que puedes realizar a Claude, Cursor o cualquier cliente MCP:

  1. ¿Cuántas charlas se dieron en 2023?

  1. "Muéstrame charlas en español"

  1. "Buscar publicaciones sobre WebXR"

Desarrollo

Características

  • Construido con el Protocolo de Contexto de Modelo (MCP)
  • Seguridad de tipos con validación de esquemas TypeScript y Zod
  • Compatibilidad nativa con TypeScript en Node.js sin transpilación
  • SDK generado mediante GenQL
  • Arquitectura modular con separación de preocupaciones
  • Transporte de E/S estándar para una fácil integración
  • Manejo estructurado de errores
  • Compatible con Claude Desktop, Cursor y MCPHost (alternativa gratuita)

Nota: Este proyecto requiere Node.js v23+ ya que utiliza el soporte nativo de TypeScript agregado el año pasado.

Arquitectura

El código base sigue una estructura modular:

src/ ├── config/ # Configuration settings ├── types/ # TypeScript interfaces and types ├── tools/ # MCP tool implementations ├── utils/ # Utility functions ├── services/ # API service layer └── index.ts # Main entry point

Pruebas

Para ejecutar el conjunto de pruebas:

npm test

Para el modo de desarrollo con reloj:

npm run test:dev

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Autor

Erick Wendel

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

-
security - not tested
A
license - permissive license
-
quality - not tested

Un servidor de protocolo de contexto modelo que permite a los agentes de IA consultar charlas, publicaciones de blog y videos de Erick Wendel en diferentes plataformas utilizando lenguaje natural.

  1. Available Tools
    1. Integration with AI Tools
      1. Inspect MCP Server Capabilities
      2. Setup
      3. Integration with AI Tools
      4. Example Queries
    2. Development
      1. Features
      2. Architecture
      3. Testing
      4. Contributing
      5. Author
      6. License
    ID: 10mv0oi9r3