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

• Комплексное тестирование : тщательно протестированная кодовая база с высоким тестовым покрытием

Related MCP server: MCP Python Interpreter

Установка

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

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

# 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. Настройте Claude Desktop, как показано в разделе «Конфигурация».

2. Запустить Claude Desktop

3. Попросите Клода поработать с файлами Figma:

   • «Можете ли вы получить информацию об этом файле Figma: 12345abcde?»

   • «Покажите мне компоненты в этом файле Figma: 12345abcde»

   • «Получить комментарии из этого файла Figma: 12345abcde»

4. Попросите Клода выполнить инструкции командной строки:

   • «Какие файлы находятся в текущем каталоге?»

   • «Какое текущее системное время?»

   • «Покажи мне содержимое определенного файла».

5. Попросите Клода загрузить подкасты с XiaoyuZhouFM:

   • "Загрузите этот эпизод подкаста: https://www.xiaoyuzhoufm.com/episode/67c3d80fb0167b8db9e3ec0f "

   • "Загрузите и конвертируйте в MP3 этот подкаст: https://www.xiaoyuzhoufm.com/episode/67c3d80fb0167b8db9e3ec0f "

6. Попросите Клода поработать с аудиофайлами:

   • «Какова длина этого аудиофайла: audio.m4a?»

   • «Транскрибируйте аудио с 60 по 90 секунды в формате audio.m4a»

   • «Получить текст с 2:30 до 3:00 в аудиофайле»

7. Попросите Клода преобразовать файлы или URL-адреса в Markdown:

   • «Преобразовать этот файл в Markdown: document.docx»

   • "Преобразовать эту веб-страницу в Markdown: https://example.com "

8. Попросите Клода поработать с веб-контентом:

   • "Получить HTML-контент с https://example.com "

   • «Сохранить HTML из https://example.com в файл»

   • «Поищите в Интернете «новости об искусственном интеллекте»»

9. Попросите Клода сгенерировать изображения с помощью Flux:

   • «Создайте изображение красивого заката над горами»

   • «Создай изображение футуристического города и сохрани его на рабочем столе»

   • «Создай портрет кота в скафандре»

10. Попросите Клода использовать инструменты памяти:

• «Запомните этот важный факт: столица Франции — Париж»

• «Какой у меня текущий идентификатор сеанса?»

• «Вспомните любую информацию о Франции»

• «Подумайте о последствиях изменения климата»

• «Забудьте все сохраненные воспоминания»

Разработка

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

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

# 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:

1. Обновите config.py , указав все необходимые ключи API.

2. Создайте новый модуль в mcp_toolbox/

3. Реализуйте свой API-клиент и инструменты

4. Добавьте тесты для вашей новой функциональности

5. Обновите README.md, добавив новые переменные среды и инструменты.

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

Внося вклад

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

1. Форк репозитория

2. Создайте ветку функций ( git checkout -b feature/amazing-feature )

3. Зафиксируйте свои изменения ( git commit -m 'Add some amazing feature' )

4. Отправить в ветку ( git push origin feature/amazing-feature )

5. Открыть запрос на извлечение

Лицензия

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