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
- Asegúrate de estar usando Node.js v23+
- Clonar este repositorio:
git clone https://github.com/erickwendel/erickwendel-contributions-mcp.git
cd erickwendel-contributions-mcp
- Restaurar dependencias:
Integración con herramientas de IA
Configuración del cursor
- Abrir configuración del cursor
- Navegar a la sección MCP
- Haga clic en "Agregar nuevo servidor MCP"
- Configurar el servidor:
Name = erickwendel-contributions
Type = command
Command = node ABSOLUTE_PATH_TO_PROJECT/src/index.ts
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"
]
}
}
}
- Asegúrese de que el chat del cursor esté en modo Agente seleccionando "Agente" en el menú desplegable de la parte inferior izquierda
- Ve al chat y pregunta "¿cuántos vídeos se publicaron sobre JavaScript en 2024?"
Configuración del escritorio de Claude
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
- Ir a la configuración de Claude
- Haga clic en la pestaña Desarrollador
- Haga clic en editar configuración
- Abra la configuración en un editor de código
- 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"
]
}
}
}
- Guardar archivo y reiniciar Claude Desktop
- Abra nuevamente la pestaña Desarrollador y verifique si está en estado "en ejecución" de la siguiente manera:
- 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.
- Instalar MCPHost:
go install github.com/mark3labs/mcphost@latest
- 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"
]
}
}
}
- 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:
- ¿Cuántas charlas se dieron en 2023?
- "Muéstrame charlas en español"
- "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:
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.