Набор инструментов MCP

mcp-набор инструментов

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

Репозиторий GitHub : https://github.com/ai-zerolab/mcp-toolbox/
(WIP) Документация : https://ai-zerolab.github.io/mcp-toolbox/

Функции

Наша основная цель — *nix, но Windows тоже должен работать.

Выполнение командной строки : выполнение любой инструкции командной строки через LLM.
Интеграция с Figma : доступ к файлам, компонентам, стилям и т. д. Figma
Расширяемая архитектура : легко добавляйте новые интеграции API
Поддержка протокола MCP : Совместимость с Claude Desktop и другими LLM с поддержкой MCP
Комплексное тестирование : тщательно протестированная кодовая база с высоким тестовым покрытием

Установка

Использование УФ (рекомендуется)

Мы рекомендуем использовать УФ-излучение для управления окружающей средой.

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh  # For macOS/Linux
# or
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"  # For Windows

Затем вы можете использовать uvx "mcp-toolbox@latest" stdio в качестве команд для запуска сервера MCP для последней версии. Инструменты для работы со звуком и памятью не включены в установку по умолчанию. , вы можете включить их, установив all дополнительные:

[audio] для аудиоинструментов, [memory] для инструментов памяти, [all] для всех инструментов

uvx "mcp-toolbox[all]@latest" stdio

Установка через Smithery

Чтобы автоматически установить Toolbox for LLM Enhancement for Claude Desktop через Smithery :

npx -y @smithery/cli install @ai-zerolab/mcp-toolbox --client claude

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

pip install "mcp-toolbox[all]"

И вы можете использовать mcp-toolbox stdio в качестве команд для запуска сервера MCP.

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

Переменные среды

Можно настроить следующие переменные среды:

FIGMA_API_KEY : API-ключ для интеграции Figma
TAVILY_API_KEY : API-ключ для интеграции Tavily
DUCKDUCKGO_API_KEY : API-ключ для интеграции DuckDuckGo
BFL_API_KEY : API-ключ для API генерации изображений Flux

Память для хранения данных

Инструменты памяти хранят данные в следующих местах:

macOS : ~/Documents/zerolab/mcp-toolbox/memory (синхронизируется между устройствами через iCloud)
Другие платформы : ~/.zerolab/mcp-toolbox/memory

Полная конфигурация

Чтобы использовать mcp-toolbox с Claude Desktop/Cline/Cursor/..., добавьте в файл конфигурации следующее:

{
  "mcpServers": {
    "zerolab-toolbox": {
      "command": "uvx",
      "args": ["--prerelease=allow", "mcp-toolbox@latest", "stdio"],
      "env": {
        "FIGMA_API_KEY": "your-figma-api-key",
        "TAVILY_API_KEY": "your-tavily-api-key",
        "DUCKDUCKGO_API_KEY": "your-duckduckgo-api-key",
        "BFL_API_KEY": "your-bfl-api-key"
      }
    }
  }
}

Для получения полного набора функций:

{
  "mcpServers": {
    "zerolab-toolbox": {
      "command": "uvx",
      "args": [
        "--prerelease=allow",
        "--python=3.12",
        "mcp-toolbox[all]@latest",
        "stdio"
      ],
      "env": {
        "FIGMA_API_KEY": "your-figma-api-key",
        "TAVILY_API_KEY": "your-tavily-api-key",
        "DUCKDUCKGO_API_KEY": "your-duckduckgo-api-key",
        "BFL_API_KEY": "your-bfl-api-key"
      }
    }
  }
}

Вы можете создать шаблон конфигурации отладки, используя:

uv run generate_config_template.py

Доступные инструменты

Инструменты командной строки

Инструмент	Описание
`execute_command`	Выполнить инструкцию командной строки

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

Инструмент	Описание
`read_file_content`	Прочитать содержимое файла
`write_file_content`	Записать содержимое в файл
`replace_in_file`	Заменить содержимое в файле с помощью регулярных выражений
`list_directory`	Список содержимого каталога с подробной информацией

Инструменты Figma

Инструмент	Описание
`figma_get_file`	Получить файл Figma по ключу
`figma_get_file_nodes`	Получить определенные узлы из файла Figma
`figma_get_image`	Получить изображения для узлов в файле Figma
`figma_get_image_fills`	Получить URL-адреса изображений, используемых в файле Figma
`figma_get_comments`	Получить комментарии к файлу Figma
`figma_post_comment`	Оставить комментарий к файлу Figma
`figma_delete_comment`	Удалить комментарий из файла Figma
`figma_get_team_projects`	Получить проекты для команды
`figma_get_project_files`	Получить файлы для проекта
`figma_get_team_components`	Получить компоненты для команды
`figma_get_file_components`	Получить компоненты из файла
`figma_get_component`	Получить компонент по ключу
`figma_get_team_component_sets`	Получить наборы компонентов для команды
`figma_get_team_styles`	Получить стили для команды
`figma_get_file_styles`	Получить стили из файла
`figma_get_style`	Получить стиль по ключу

Инструменты XiaoyuZhouFM

Инструмент	Описание
`xiaoyuzhoufm_download`	Загрузите эпизод подкаста с XiaoyuZhouFM с возможностью автоматического преобразования m4a в mp3

Аудио инструменты

Инструмент	Описание
`get_audio_length`	Получить длину аудиофайла в секундах
`get_audio_text`	Получите транскрибированный текст из определенного временного диапазона в аудиофайле

Инструменты памяти

Инструмент	Описание
`think`	Используйте инструмент, чтобы подумать о чем-то и добавить мысль в журнал
`get_session_id`	Получить текущий идентификатор сеанса
`remember`	Сохраните воспоминание (краткое и подробное) в базе данных памяти.
`recall`	Запрос воспоминаний из базы данных с помощью семантического поиска
`forget`	Очистить все воспоминания в базе данных памяти

Инструменты Markitdown

Инструмент	Описание
`convert_file_to_markdown`	Конвертируйте любой файл в Markdown с помощью MarkItDown
`convert_url_to_markdown`	Конвертируйте URL в Markdown с помощью MarkItDown

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

Инструмент	Описание
`get_html`	Получить HTML-контент из URL
`save_html`	Сохранить HTML из URL в файл
`search_with_tavily`	Поиск в Интернете с помощью Tavily (требуется ключ API)
`search_with_duckduckgo`	Поиск в Интернете с помощью DuckDuckGo (требуется ключ API)

Инструменты создания изображений Flux

Инструмент	Описание
`flux_generate_image`	Создайте изображение с помощью Flux API и сохраните его в файл.

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

Запуск сервера MCP

# Run with stdio transport (default)
mcp-toolbox stdio

# Run with SSE transport
mcp-toolbox sse --host localhost --port 9871

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

Настройте Claude Desktop, как показано в разделе «Конфигурация».
Запустить Claude Desktop
Попросите Клода поработать с файлами Figma:
- «Можете ли вы получить информацию об этом файле Figma: 12345abcde?»
- «Покажите мне компоненты в этом файле Figma: 12345abcde»
- «Получить комментарии из этого файла Figma: 12345abcde»
Попросите Клода выполнить инструкции командной строки:
- «Какие файлы находятся в текущем каталоге?»
- «Какое текущее системное время?»
- «Покажи мне содержимое определенного файла».
Попросите Клода загрузить подкасты с XiaoyuZhouFM:
- "Загрузите этот эпизод подкаста: https://www.xiaoyuzhoufm.com/episode/67c3d80fb0167b8db9e3ec0f "
- "Загрузите и конвертируйте в MP3 этот подкаст: https://www.xiaoyuzhoufm.com/episode/67c3d80fb0167b8db9e3ec0f "
Попросите Клода поработать с аудиофайлами:
- «Какова длина этого аудиофайла: audio.m4a?»
- «Транскрибируйте аудио с 60 по 90 секунды в формате audio.m4a»
- «Получить текст с 2:30 до 3:00 в аудиофайле»
Попросите Клода преобразовать файлы или URL-адреса в Markdown:
- «Преобразовать этот файл в Markdown: document.docx»
- "Преобразовать эту веб-страницу в Markdown: https://example.com "
Попросите Клода поработать с веб-контентом:
- "Получить HTML-контент с https://example.com "
- «Сохранить HTML из https://example.com в файл»
- «Поищите в Интернете «новости об искусственном интеллекте»»
Попросите Клода сгенерировать изображения с помощью Flux:
- «Создайте изображение красивого заката над горами»
- «Создай изображение футуристического города и сохрани его на рабочем столе»
- «Создай портрет кота в скафандре»
Попросите Клода использовать инструменты памяти:

«Запомните этот важный факт: столица Франции — Париж»
«Какой у меня текущий идентификатор сеанса?»
«Вспомните любую информацию о Франции»
«Подумайте о последствиях изменения климата»
«Забудьте все сохраненные воспоминания»

Разработка

Локальная настройка

Создайте форк репозитория и клонируйте его на локальную машину.

# Install in development mode
make install
# Activate a virtual environment
source .venv/bin/activate  # For macOS/Linux
# or
.venv\Scripts\activate  # For Windows

Проведение тестов

make test

Проведение проверок

make check

Строительная документация

make docs

Добавление новых инструментов

Чтобы добавить новую интеграцию API:

Обновите config.py , указав все необходимые ключи API.
Создайте новый модуль в mcp_toolbox/
Реализуйте свой API-клиент и инструменты
Добавьте тесты для вашей новой функциональности
Обновите README.md, добавив новые переменные среды и инструменты.

Более подробные инструкции см. в руководстве по разработке .

Внося вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

Форк репозитория
Создайте ветку функций ( git checkout -b feature/amazing-feature )
Зафиксируйте свои изменения ( git commit -m 'Add some amazing feature' )
Отправить в ветку ( git push origin feature/amazing-feature )
Открыть запрос на извлечение

Лицензия

Данный проект лицензирован в соответствии с условиями лицензии, включенной в репозиторий.

Integrations