Шаблон сервера 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", }, ], }; } );