Стартовый сервер MCP

Готовый к использованию стартовый шаблон для создания серверов Model Context Protocol (MCP) с помощью TypeScript.

🚀 Быстрый старт

Клонировать репозиторий
Установить зависимости:
bun install

✨ Основные характеристики

Баночка для быстрого тестирования и разработки
Биом для линтинга и форматирования
Автоматизированное управление версиями со стандартной версией
Чистая, удобная в обслуживании структура проекта

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

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

⚙️ Конфигурация

Создание новых инструментов

Проект включает в себя скрипт, помогающий создавать новые инструменты MCP:

bun run scripts/create-tool.ts <tool-name>

Это позволит:

Создайте новый каталог инструментов в src/tools/<tool-name>
Сгенерируйте базовую структуру инструмента, включая:
- index.ts (основная реализация)
- schema.ts (схема JSON для параметров инструмента)
- test.ts (тестовый файл)
Обновите файл индекса инструментов, чтобы экспортировать новый инструмент.

Пример:

bun run scripts/create-tool.ts weather

🛠️ Развитие

Проведите тесты : bun test
Код формата : bun run format
Код линта : bun run lint
Проект сборки : bun run build

Чтобы добавить сервер MCP для разработки в Claude Desktop:

Создайте проект:
bun run build
Добавьте в конфигурацию 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"] } } }

📜 Управление версиями

Этот проект использует standard-version для автоматизированного управления версиями. Запустите bun run release для создания новой версии.

Формат сообщения о фиксации

feat : Новая функция (увеличивает младшую версию)
fix : исправление ошибки (версия исправления ошибок)
BREAKING CHANGE : Критическое изменение (увеличивает основную версию)

📦 Публикация в npm

Убедитесь, что вы вошли в систему npm:
npm login
Создайте проект:
bun run build
Опубликовать пакет:
npm publish

Не забудьте обновить номер версии с помощью bun run release перед публикацией новых версий.

Установка из npm (после публикации)

Добавьте в конфигурацию 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"]
    }
  }
}

MCP Server Starter

Integrations