Plantilla de servidor MCP 🛠️

Una plantilla de inicio para crear tu propio servidor de Protocolo de Contexto de Modelo (MCP). Esta plantilla proporciona la estructura y configuración básicas necesarias para crear MCP personalizados que se pueden usar con Cursor o Claude Desktop.

Características

Configuración básica del servidor MCP con TypeScript
Implementación de la herramienta de muestra
Estructura de proyecto lista para usar
Creado con @modelcontextprotocol/sdk

Related MCP server: MCP Server Boilerplate

Estructura del proyecto

mcp-server-template/
├── index.ts        # Main server implementation
├── package.json    # Project dependencies
├── tsconfig.json   # TypeScript configuration
└── build/         # Compiled JavaScript output

Empezando

Clonar esta plantilla:

git clone [your-repo-url] my-mcp-server
cd my-mcp-server

Instalar dependencias:

pnpm install

Construir el proyecto:

pnpm run build

Esto generará el archivo /build/index.js : su script de servidor MCP compilado.

Uso con cursor

Vaya a Configuración del cursor -> MCP -> Agregar nuevo servidor MCP
Configura tu MCP:
- Nombre: [elige tu propio nombre]
- Tipo: comando
- Comando: node ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js

Uso con Claude Desktop

Agregue la siguiente configuración de MCP a su configuración de Claude Desktop:

{
  "mcpServers": {
    "your-mcp-name": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js"]
    }
  }
}

Desarrollo

La plantilla incluye un ejemplo de implementación de la herramienta en index.ts . Para crear su propio MCP:

Modificar la configuración del servidor en index.ts :

const server = new McpServer({
  name: "your-mcp-name",
  version: "0.0.1",
});

Define tus herramientas personalizadas utilizando el método server.tool() :

server.tool(
  "your-tool-name",
  "Your tool description",
  {
    // Define your tool's parameters using Zod schema
    parameter: z.string().describe("Parameter description"),
  },
  async ({ parameter }) => {
    // Implement your tool's logic here
    return {
      content: [
        {
          type: "text",
          text: "Your tool's response",
        },
      ],
    };
  }
);