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 necesidad de instalación:

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

Añade esta configuración a:

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

• Cursor: ~/.cursor/mcp.json

Related MCP server: mintlify-mcp

Herramientas disponibles

Este servidor MCP proporciona las siguientes capacidades:

Herramientas

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

  • Admite 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

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

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

  • Admite 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 la 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 las 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 de Cursor

Añade 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 "how many videos were published about JavaScript in 2024":

Desarrollo local

Para el 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 de Claude Desktop

1. Ve a la configuración de Claude

2. Haz clic en la pestaña Developer

3. Haz clic en edit config

4. Abre la configuración en un editor de código

5. Añade 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 el 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 (ej. ./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 el 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í tienes algunos ejemplos de consultas que puedes hacer a Claude, Cursor o cualquier cliente MCP:

1. "How many talks were given in 2023?"

2. "Show me talks in Spanish"

3. "Find posts about WebXR"

Desarrollo

Características

• Construido con Model Context Protocol (MCP)

• Capacidades MCP completas: Herramientas, Prompts y Recursos

• Tipado seguro con 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 de E/S estándar para una fácil integración

• Manejo de errores estructurado

• Compatible con Claude Desktop, Cursor y MCPHost (alternativa gratuita)

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

Arquitectura

La base de código 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 watch:

npm run test:dev

Contribuciones

¡Las contribuciones son bienvenidas! Por favor, siéntete libre de enviar un Pull Request.

Autor

Erick Wendel

Licencia

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