Iniciador del servidor MCP

Una plantilla de inicio lista para producción para crear servidores de Protocolo de contexto de modelo (MCP) con TypeScript.

🚀 Inicio rápido

Clonar el repositorio
Instalar dependencias:
bun install

✨ Características principales

Bun para pruebas y desarrollo rápidos
Bioma para el linting y el formateo
Gestión automatizada de versiones con versión estándar
Estructura de proyecto limpia y mantenible

📂 Estructura del proyecto

mcp-starter/
├── src/
│   ├── tools/          # MCP tools implementation
│   ├── utils/          # Shared utilities
│   ├── main.ts         # Server entry point
│   └── types.ts        # Shared type definitions
├── tests/              # Test files
├── biome.json          # Linting configuration
├── tsconfig.json       # TypeScript configuration
└── package.json        # Project dependencies

⚙️ Configuración

Creando nuevas herramientas

El proyecto incluye un script para ayudar a crear nuevas herramientas MCP:

bun run scripts/create-tool.ts <tool-name>

Esto hará lo siguiente:

Cree un nuevo directorio de herramientas en src/tools/<tool-name>
Genere la estructura básica de la herramienta incluyendo:
- index.ts (implementación principal)
- schema.ts (esquema JSON para parámetros de herramientas)
- test.ts (archivo de prueba)
Actualice el archivo de índice de herramientas para exportar la nueva herramienta

Ejemplo:

bun run scripts/create-tool.ts weather

🛠️ Desarrollo

Ejecutar pruebas : bun test
Código de formato : bun run format
Código de pelusa : bun run lint
Proyecto de construcción : bun run build

Para agregar su servidor MCP de desarrollo a Claude Desktop:

Construir el proyecto:
bun run build
Añade a tu configuración de Claude Desktop:
// You only need the argument if you need to pass arguments to your server { "mcpServers": { "your-server-name": { "command": "node", "args": ["/path/to/your/project/dist/main.js", "some_argument"] } } }

📜 Gestión de versiones

Este proyecto utiliza la versión estándar para la gestión automatizada de versiones. Ejecute bun run release para crear una nueva versión.

Formato del mensaje de confirmación

feat : Nueva característica (mejora versión menor)
fix : Corrección de errores (versión del parche de mejoras)
BREAKING CHANGE : Cambio radical (incrementa la versión principal)

📦 Publicación en npm

Asegúrese de haber iniciado sesión en npm:
npm login
Construir el proyecto:
bun run build
Publicar el paquete:
npm publish

Recuerde actualizar el número de versión utilizando bun run release antes de publicar nuevas versiones.

Instalación mediante herrería

Para instalar Weather MCP Server Starter para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @GreatAuk/mcp-weather --client claude

Instalación desde npm (después de publicar)

Añade a tu configuración de Claude Desktop:

// You only need the argument if you need to pass arguments to your server
{
  "mcpServers": {
    "your-server-name": {
      "command": "npx",
      "args": ["-y", "your-package-name", "some_argument"]
    }
  }
}

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

Tools

hello_tool

Una plantilla basada en TypeScript para crear servidores de Protocolo de Contexto de Modelo, con pruebas rápidas, gestión de versiones automatizada y una estructura limpia para implementaciones de herramientas MCP.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Server Starter
StevenStavrakis
A
security
A
license
A
quality
A production-ready template for creating Model Context Protocol servers with TypeScript, providing tools for efficient testing, development, and deployment.
Last updated -
1
1
12
JavaScript
MIT License
MCP Server Starter
coinselor
A
security
A
license
A
quality
A production-ready template for building Model Context Protocol servers in TypeScript, offering fast development with Bun, Biome linting, and automated version management.
Last updated -
1
1
JavaScript
MIT License
MCP Server Template
stevennevins
A
security
F
license
A
quality
A template for creating Model Context Protocol (MCP) servers in TypeScript, offering features like container-based dependency injection, a service-based architecture, and integration with the LLM CLI for architectural design feedback through natural language.
Last updated -
1
5
TypeScript
MCP Framework
ronangrant
-
security
F
license
-
quality
A TypeScript framework for building Model Context Protocol (MCP) servers with automatic discovery and loading of tools, resources, and prompts.
Last updated -
67
TypeScript

View all related MCP servers

MCP Server Starter