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:

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+

2. Clonar este repositorio:

3. Restaurar dependencias:

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:

o si prefieres ejecutarlo desde Smithery

5. Asegúrese de que el chat del cursor esté en modo Agente seleccionando "Agente" en el menú desplegable de la parte inferior izquierda

6. 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 :

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:

o si prefieres ejecutarlo desde Smithery

6. Guardar archivo y reiniciar Claude Desktop

7. Abra nuevamente la pestaña Desarrollador y verifique si está en estado "en ejecución" de la siguiente manera:

8. 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:

2. Cree un archivo de configuración (por ejemplo , ./mcp.jsonc ):

o si prefieres ejecutarlo desde Smithery

3. Ejecute MCPHost con su modelo Ollama preferido:

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?

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

3. "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:

Pruebas

Para ejecutar el conjunto de pruebas:

Para el modo de desarrollo con reloj:

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.