Erick Wendel Contributions

erickwendel-contributions-mcp

Un servidor de Model Context Protocol (MCP) que proporciona herramientas para consultar las contribuciones de Erick Wendel en diferentes plataformas. Consulta charlas, publicaciones de blog y videos usando lenguaje natural a través de Claude, Cursor o similares. Este proyecto fue construido usando el IDE Cursor con el agente predeterminado (versión de prueba).

Inicio Rápido

Usa este servidor MCP directamente con Claude Desktop o Cursor sin instalación:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

Agrega esta configuración a:

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
• Cursor: ~/.cursor/mcp.json

Herramientas Disponibles

Este servidor MCP proporciona las siguientes capacidades:

Herramientas

• get-talks: Recupera una lista paginada de charlas con filtrado opcional

  • Soporta filtrado por ID, título, idioma, ciudad, país y año
  • Puede devolver conteos agrupados por idioma, país o ciudad

• get-posts: Obtiene publicaciones con filtrado y paginación opcionales

  • Soporta filtrado por ID, título, idioma y portal

• get-videos: Recupera videos con filtrado y paginación opcionales

  • Soporta filtrado por ID, título e idioma

• check-status: Verifica si la API está activa y respondiendo

Prompts

• find-content: Genera consultas para encontrar contenido específico por tipo, tema e idioma
• summarize-activity: Crea resúmenes de actividad de contenido por año

Recursos

• erickwendel://about: Información del servidor y metadatos de capacidades
• erickwendel://statistics: Estadísticas de contenido y consultas disponibles

Integración con Herramientas de IA

Inspeccionar Capacidades del Servidor MCP

Puedes inspeccionar las capacidades de este servidor MCP usando el Inspector MCP:

npm run inspect

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

Configuración

1. Asegúrate de estar usando Node.js v20+

node -v
# v20.x.x or higher

2. Clona este repositorio:

git clone https://github.com/erickwendel/erickwendel-contributions-mcp.git
cd erickwendel-contributions-mcp

3. Instala las dependencias:

npm ci

4. Ejecuta el servidor:

npm start

Integración con Herramientas de IA

Configuración en Cursor

Agrega la siguiente configuración a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

Asegúrate de que el chat de Cursor esté en modo Agente seleccionando "Agent" en el menú desplegable de la parte inferior izquierda, luego pregunta "¿cuántos videos se publicaron sobre JavaScript en 2024?":

Desarrollo Local

Para desarrollo local, usa la ruta absoluta al proyecto:

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

Configuración en Claude Desktop

1. Ve a la configuración de Claude
2. Haz clic en la pestaña Desarrollador
3. Haz clic en editar configuración
4. Abre la configuración en un editor de código
5. Agrega la siguiente configuración a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

Desarrollo Local

Para desarrollo local, usa la ruta absoluta al proyecto:

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

MCPHost con Ollama (Alternativa Gratuita)

Si no tienes acceso a Claude Desktop o Cursor, puedes usar MCPHost con Ollama como alternativa gratuita.

1. Instala MCPHost:

go install github.com/mark3labs/mcphost@latest

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

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

3. Ejecuta con Ollama:

ollama pull MODEL_NAME
mcphost --config ./mcp.jsonc -m ollama:MODEL_NAME

Desarrollo Local

Para desarrollo local, actualiza la configuración:

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

Ejemplos de Consultas

Aquí hay algunos ejemplos de consultas que puedes hacer a Claude, Cursor o cualquier Cliente MCP:

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

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

3. "Encuentra publicaciones sobre WebXR"

Desarrollo

Características

• Construido con Model Context Protocol (MCP)
• Capacidades MCP Completas: Herramientas, Prompts y Recursos
• Seguro con tipos usando TypeScript y validación de esquemas Zod
• Soporte nativo de TypeScript en Node.js sin transpilación
• SDK generado usando GenQL
• Arquitectura modular con separación de responsabilidades
• Transporte estándar de E/S para 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 usa 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 modo de desarrollo con vigilancia:

npm run test:dev

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request.

Autor

Erick Wendel

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.