hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Used for linting and formatting in the project
Used for fast testing and development in the project
The project can be published to npm registry

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.

A

security – no known vulnerabilities

A

license - permissive license

A

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