Шаблон сервера MCP 🛠️

Начальный шаблон для создания собственного сервера Model Context Protocol (MCP). Этот шаблон обеспечивает базовую структуру и настройку, необходимые для создания пользовательских MCP, которые можно использовать с Cursor или Claude Desktop.

Функции

Базовая настройка сервера MCP с TypeScript
Пример реализации инструмента
Готовая к использованию структура проекта
Создано с помощью @modelcontextprotocol/sdk

Related MCP server: MCP Server Boilerplate

Структура проекта

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

Начиная

Клонируйте этот шаблон:

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

Установить зависимости:

pnpm install

Создайте проект:

pnpm run build

Это сгенерирует файл /build/index.js — ваш скомпилированный скрипт сервера MCP.

Использование с курсором

Перейдите в Настройки курсора -> MCP -> Добавить новый сервер MCP.
Настройте свой MCP:
- Имя: [выберите свое имя]
- Тип: команда
- Команда: node ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js

Использование с Claude Desktop

Добавьте следующую конфигурацию MCP в конфигурацию Claude Desktop:

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

Разработка

Шаблон включает в себя пример реализации инструмента в index.ts . Чтобы создать свой собственный MCP:

Измените конфигурацию сервера в index.ts :

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

Определите свои пользовательские инструменты с помощью метода 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",
        },
      ],
    };
  }
);