local-only server

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

Integrations

Integrates with Biome for linting and formatting of the MCP server codebase.
Uses Bun for fast testing and development of the MCP server.
Supports publishing the MCP server as an npm package for easy distribution and installation.

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 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 lista para producción para crear servidores de Protocolo de contexto de modelo con TypeScript, que proporciona herramientas para pruebas, desarrollo e implementación eficientes.

Related Resources

Reddit Discussion about this server

MCP Server Starter