Servidor de inicio MCP

Una plantilla de servidor ModelContextProtocol minimalista para crear herramientas de asistentes de IA. Esta plantilla de inicio proporciona una estructura básica para crear herramientas MCP compatibles con asistentes de IA como Claude.

Características

Ejemplo simple de la herramienta "Hola mundo"
Configuración de TypeScript + esbuild
Herramientas de desarrollo preconfiguradas

Configuración para construir y ejecutar con Claude

Descargue e instale la aplicación de escritorio Claude desde claude.ai/download
Clonar el repositorio, instalar dependencias y compilar:

npm install
npm run build

Configure Claude para usar este servidor MCP. Si este es su primer servidor MCP, ejecute lo siguiente en la raíz del proyecto:

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

Esto debería generar una entrada en su claude_desktop_config.json como:

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

Si ya tiene servidores MCP, agregue el bloque mcp-starter a su configuración. Es importante que el args sea la ruta a <path_to_repo_on_your_machine>/mcp-starter/dist/index.cjs .

Reinicie Claude Desktop.
Busque el ícono del martillo con el número de herramientas disponibles en la interfaz de Claude para confirmar que el servidor está funcionando.
Si todo esto funciona, deberías poder desarrollar tu servidor MCP con npm run dev y probarlo en Claude. Deberás reiniciar Claude cada vez que se reinicie el servidor MCP.

Desarrollando con Inspector

Para fines de desarrollo y depuración, puede utilizar la herramienta Inspector de MCP. El Inspector proporciona una interfaz visual para probar y supervisar las interacciones con el servidor MCP.

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

Para realizar pruebas locales con Inspector:

npm run inspect

Para aprovechar los cambios de archivo, ejecute:

npm run watch

O ejecute tanto el observador como el inspector:

npm run dev

Publicación

¡Una vez que esté listo para distribuir su servidor, es simple!

Configurar una cuenta NPM .
Ejecute npm publish . Esto publicará un paquete con el nombre del proyecto en package.json
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

Creando nuevas herramientas

Para agregar nuevas herramientas:

Defina el esquema de herramientas en index.ts
Agreguelo a la matriz de herramientas en el controlador ListToolsRequestSchema
Agregue la implementación en el controlador CallToolRequestSchema

Vea la implementación hello_tool como ejemplo.

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

hello_tool

Este servidor proporciona una plantilla mínima para crear herramientas de asistente de IA utilizando ModelContextProtocol, presenta un ejemplo de herramienta "hola mundo" simple y configuraciones de desarrollo para crear herramientas MCP personalizadas.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Awesome MCP FastAPI
MR-GREEN1337
-
security
F
license
-
quality
A production-ready MCP server built with FastAPI, providing an enhanced tool registry for creating, managing, and documenting AI tools for Large Language Models (LLMs).
Last updated -
13
Python
Workers MCP Demo
akazwz
-
security
F
license
-
quality
A demonstration project that uses Cloudflare Workers MCP to create custom AI tools that can be integrated with Claude, Cursor, and other AI assistants supporting the Model Context Protocol.
Last updated -
26
TypeScript
MCP Server Template
jatinsandilya
A
security
F
license
A
quality
A starter template for building Model Context Protocol servers that can be integrated with Cursor or Claude Desktop, allowing developers to create custom tools and extensions for AI assistants.
Last updated -
1
6
9
TypeScript
Foundry MCP Server
qwert666
-
security
A
license
-
quality
An MCP server that allows AI assistants to interact with Foundry datasets, ontology objects, and functions through natural language queries and commands.
Last updated -
2
Python
MIT License

View all related MCP servers

MCP Starter Server