🔧 MCP Toolkit Server

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

✨ Возможности

📁 Инструменты для работы с файлами

• list_directory — вывод содержимого каталога

• read_file — чтение текстового файла

• write_file — запись/добавление в файл

• file_info — получение метаинформации о файле

• search_files — поиск файлов по шаблону

🗄️ Инструменты для работы с базами данных

• query_database — выполнение SQL SELECT-запросов (безопасный режим только для чтения)

• list_tables — вывод списка всех таблиц

• describe_table — просмотр структуры таблицы

• init_sample_database — инициализация демонстрационной базы данных

🌐 Веб-инструменты

• web_search — веб-поиск через DuckDuckGo (без API-ключа)

• fetch_webpage — извлечение основного содержимого веб-страницы

• webpage_info — получение метаинформации о веб-странице

🧮 Инструменты для вычислений

• calculate — безопасное вычисление математических выражений

• convert_unit — конвертация единиц измерения (длина/вес/температура/площадь/объём)

• date_calculation — вычисления с датами (разница/сложение/вычитание)

• percentage_calculation — вычисление процентов

Related MCP server: Claude Code Control MCP

🏗️ Архитектура

┌─────────────────────────────────────────────────────┐
│              MCP 客户端 (Claude/Cursor)              │
└──────────────────────┬──────────────────────────────┘
                       │ MCP Protocol (stdio / HTTP)
┌──────────────────────▼──────────────────────────────┐
│              FastMCP Server 核心                      │
│  ┌──────────┐ ┌──────────┐ ┌────────┐ ┌──────────┐ │
│  │ 文件工具  │ │ 数据库工具│ │Web工具 │ │ 计算工具  │ │
│  └──────────┘ └──────────┘ └────────┘ └──────────┘ │
└─────────────────────────────────────────────────────┘

📦 Установка

# 克隆仓库
git clone <repo-url>
cd mcp-toolkit-server

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env

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

1. Запуск напрямую (режим stdio)

python server.py

2. Режим HTTP

python server.py --transport http --host 127.0.0.1 --port 8000

3. Подключение к Claude Desktop

Отредактируйте файл конфигурации Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "toolkit": {
      "command": "python",
      "args": ["path/to/mcp-toolkit-server/server.py"],
      "env": {
        "ALLOWED_DIRS": "/path/to/your/workspace"
      }
    }
  }
}

4. Подключение к Cursor

В настройках Cursor → MCP добавьте:

{
  "mcpServers": {
    "toolkit": {
      "command": "python",
      "args": ["path/to/mcp-toolkit-server/server.py"]
    }
  }
}

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

mcp-toolkit-server/
├── server.py                 # MCP 服务器主入口
├── config.py                 # 配置管理
├── requirements.txt          # 依赖
├── .env.example              # 环境变量模板
├── .gitignore
├── README.md
└── src/
    ├── __init__.py
    └── tools/
        ├── __init__.py
        ├── file_tools.py     # 文件操作工具
        ├── db_tools.py       # 数据库查询工具
        ├── web_tools.py      # Web 搜索/抓取工具
        └── calc_tools.py     # 计算/转换工具

🔒 Механизмы безопасности

1. Изоляция путей: файловые операции ограничены каталогами, указанными в конфигурации ALLOWED_DIRS, что предотвращает обход путей

2. Только чтение SQL: инструменты базы данных разрешают только SELECT-запросы, запрещая операции записи

3. Проверка идентификаторов: такие идентификаторы, как имена таблиц, проверяются регулярными выражениями для предотвращения SQL-инъекций

4. Песочница для выражений: математические вычисления используют ограниченную среду eval, доступ к встроенным функциям запрещён

🎯 Ключевые преимущества

1. Соответствие спецификации MCP: основан на официальном фреймворке FastMCP, совместим со всеми MCP-клиентами

2. Богатый набор инструментов: 4 категории, 17 инструментов, покрывающих типовые сценарии разработки

3. Безопасность в приоритете: многоуровневые механизмы защиты от злоупотреблений

4. Лёгкость расширения: модульная архитектура — для добавления нового инструмента достаточно написать функцию и зарегистрировать её

5. Два режима передачи: поддержка stdio (локальный) и HTTP (удалённый)

🤝 Направления развития

• Добавить инструменты для работы с Git

• Добавить инструмент выполнения кода (в песочнице)

• Добавить инструмент отправки электронной почты

• Добавить инструмент управления календарём

• Поддержка детального контроля прав доступа к инструментам

• Добавить журнал аудита вызовов инструментов

📄 Лицензия

MIT