MCP Toolkit Server

Обзор

MCP Toolkit Server — это готовый к использованию в продакшене сервер Model Context Protocol (MCP), который оснащает Claude, ChatGPT и другие LLM-агенты богатым набором инструментов для взаимодействия с базами данных, внешними API, файловой системой и многим другим — что напрямую относится к волне агентного ИИ.

Созданный на TypeScript с использованием официального SDK @modelcontextprotocol/sdk, этот сервер работает как локальный процесс stdio и легко интегрируется с Claude Desktop, MCP Inspector или любым другим клиентом, поддерживающим MCP.

Related MCP server: MCP Toolkit

Функции и инструменты

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

Предварительные требования

• Node.js >= 18.0.0

• npm >= 9.0.0

Установка

# Clone the repository
git clone https://github.com/vyshnavi-nandyala/mcp-toolkit-server.git
cd mcp-toolkit-server

# Install dependencies
npm install

# Build the TypeScript project
npm run build

Настройка Claude Desktop

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

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "toolkit": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-toolkit-server/dist/index.js"]
    }
  }
}

Замените /absolute/path/to/mcp-toolkit-server на реальный путь на вашем компьютере.

Перезапустите Claude Desktop, и вы увидите иконку 🔨 в области ввода — ваши инструменты готовы!

Использование с MCP Inspector (Отладка)

npx @modelcontextprotocol/inspector node dist/index.js

Это откроет веб-интерфейс, где вы сможете вручную протестировать каждый инструмент, изучить полезную нагрузку запросов/ответов и отладить проблемы.

Примеры использования

SQL-запрос — Исследование демо-базы данных

Спросите Claude:

"Покажи мне топ-5 товаров по цене из демо-базы данных."

Claude использует инструмент db_query:

{
  "sql": "SELECT name, category, price FROM products ORDER BY price DESC LIMIT 5"
}

Вызов API — Получение данных о погоде

Спросите Claude:

"Какая сейчас погода в Сан-Франциско?"

Claude использует инструмент api_call:

{
  "url": "https://api.open-meteo.com/v1/forecast?latitude=37.7749&longitude=-122.4194&current_weather=true",
  "method": "GET"
}

Операции с файлами

Спросите Claude:

"Перечисли все TypeScript-файлы в моем проекте, а затем прочитай основной файл."

Claude объединит file_list → file_read:

{ "dirPath": "/path/to/project", "extension": ".ts", "recursive": true }
{ "filePath": "/path/to/project/src/index.ts" }

Парсинг JSON

Спросите Claude:

"Разбери этот JSON и извлеки email первого пользователя: {"users":[{"email":"alice@example.com"},{"email":"bob@example.com"}]}"

{
  "json": "{\"users\":[{\"email\":\"alice@example.com\"}]}",
  "operation": "query",
  "path": "users[0].email"
}

Преобразование текста

Спросите Claude:

"Преобразуй это в camelCase и slug: 'My Project Name'"

{ "text": "My Project Name", "operation": "camelcase" }
// → "myProjectName"

{ "text": "My Project Name", "operation": "slug" }
// → "my-project-name"

Архитектура

mcp-toolkit-server/
├── src/
│   ├── index.ts                  # Entry point — creates and starts the MCP server
│   ├── tools/
│   │   ├── db-query.ts           # SQLite query tool (explore + file modes)
│   │   ├── api-call.ts           # HTTP request tool (fetch-based)
│   │   ├── file-operations.ts    # file_read, file_write, file_list
│   │   ├── calculator.ts         # Safe math expression evaluator
│   │   ├── datetime.ts           # Date/time with timezone support
│   │   ├── json-parser.ts        # Parse, query, validate, summarize JSON
│   │   ├── text-transform.ts     # 17+ text manipulation operations
│   │   └── environment.ts        # System environment info
│   └── utils/
│       └── helpers.ts            # Shared response-building utilities
├── tests/
│   └── tools.test.ts             # Unit tests (vitest)
├── package.json
├── tsconfig.json
└── README.md

Принципы проектирования

1. Безопасность прежде всего — предотвращение SQL-инъекций, отсутствие eval(), настройки "только для чтения" по умолчанию для БД

2. Модульность — каждый инструмент является автономным модулем; легко добавлять/удалять инструменты

3. Типизация — полный TypeScript со схемами Zod для валидации ввода

4. Наблюдаемость — структурированные JSON-ответы с метаданными (время выполнения, количество, типы)

5. Удобство для разработчиков — поддержка MCP Inspector, подробный README, модульные тесты

Добавление пользовательских инструментов

Добавление нового инструмента выполняется просто:

// src/tools/my-custom-tool.ts
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { z } from "zod";

export function registerMyCustomTool(server: McpServer): void {
  server.tool(
    "my_custom_tool",
    "Description of what this tool does.",
    {
      param1: z.string().describe("First parameter."),
      param2: z.number().optional().describe("Optional second parameter."),
    },
    async ({ param1, param2 }) => {
      // Your logic here
      return {
        content: [
          { type: "text", text: JSON.stringify({ result: "..." }, null, 2) },
        ],
      };
    }
  );
}

Затем зарегистрируйте его в src/index.ts:

import { registerMyCustomTool } from "./tools/my-custom-tool.js";
// ...
registerMyCustomTool(this.server);

Разработка

# Run in development mode (no build step needed)
npm run dev

# Build for production
npm run build

# Run tests
npm test

# Watch tests
npm run test:watch

# Lint
npm run lint

Почему это важно: Волна агентного ИИ

MCP (Model Context Protocol) — это открытый стандарт, который позволяет ИИ-агентам, таким как Claude, взаимодействовать с внешними инструментами, источниками данных и сервисами. Вместо того чтобы быть ограниченными окном чата, MCP-серверы дают агентам возможность:

• Запрашивать базы данных на естественном языке

• Вызывать внешние API для получения данных в реальном времени

• Читать и записывать файлы в локальной файловой системе

• Выполнять вычисления и преобразования данных

• Создавать многошаговые рабочие процессы, объединяя инструменты вместе

Этот сервер — конкретная, готовая к использованию реализация этого видения — набор инструментов, который превращает Claude из разговорного ИИ в действующего агента, способного взаимодействовать с реальным миром.

Лицензия

Лицензия MIT. Подробности см. в LICENSE.