MCP Starter Server

MCP Starter Server

Una plantilla mínima de servidor ModelContextProtocol para construir herramientas de asistentes de IA. Este starter proporciona una estructura básica para crear herramientas MCP que pueden usarse con asistentes de IA como Claude.

Características

• Ejemplo simple de herramienta "hola mundo"
• Configuración de TypeScript + esbuild
• Herramientas de desarrollo preconfiguradas

Configuración para compilar y ejecutar con Claude

1. Descarga e instala la aplicación de escritorio de Claude desde claude.ai/download

2. Clona el repositorio, instala las dependencias y compila:

npm install
npm run build

3. Configura Claude para usar este servidor MCP. Si este es tu primer servidor MCP, en la raíz de este proyecto ejecuta:

echo '{
  "mcpServers": {
    "mcp-starter": {
      "command": "node",
      "args": ["'$PWD'/dist/index.cjs"]
    }
  }
}' > ~/Library/Application\ Support/Claude/claude_desktop_config.json

Esto debería resultar en una entrada en tu claude_desktop_config.json como:

"mcpServers": {
  "mcp-starter": {
    "command": "node",
    "args": ["/Users/matt/code/mcp-starter/dist/index.cjs"]
  }
}

Si ya tienes servidores MCP existentes, agrega el bloque mcp-starter a tu configuración existente. Es un detalle importante que el args sea la ruta a <path_to_repo_on_your_machine>/mcp-starter/dist/index.cjs.

4. Reinicia Claude Desktop.

5. Busca el ícono de martillo con el número de herramientas disponibles en la interfaz de Claude para confirmar que el servidor está ejecutándose.

6. Si todo funciona, deberías poder desarrollar tu servidor MCP usando npm run dev y probarlo en Claude. Necesitarás reiniciar Claude cada vez para reiniciar el servidor MCP.

Desarrollo con Inspector

Para fines de desarrollo y depuración, puedes usar la herramienta MCP Inspector. El Inspector proporciona una interfaz visual para probar y monitorear las interacciones del servidor MCP.

Visita la documentación de Inspector para instrucciones detalladas de configuración.

Para probar localmente con Inspector:

npm run inspect

Para compilar con cambios en archivos, ejecuta:

npm run watch

O ejecuta tanto el observador como el inspector:

npm run dev

Publicación

Cuando estés listo para distribuir tu servidor, ¡es simple!

1. Crea una cuenta en NPM.

2. Ejecuta npm publish. Esto publicará un paquete usando el nombre del proyecto en package.json

3. Una vez publicado, otros pueden instalar el servidor con una entrada de configuración como:

"mcpServers": {
  "<your-package-name>": {
    "command": "npx",
    "args": ["<your-package-name>"]
  }
}

Herramientas Disponibles

El servidor proporciona:

• hello_tool: Una herramienta de ejemplo simple que toma un parámetro de nombre y devuelve un saludo

Creación de Nuevas Herramientas

Para agregar nuevas herramientas:

1. Define el esquema de la herramienta en index.ts
2. Agrégalo al arreglo de herramientas en el manejador ListToolsRequestSchema
3. Agrega la implementación en el manejador CallToolRequestSchema

Consulta la implementación de hello_tool como ejemplo.