A
securityF
licenseA
qualityEnables seamless interaction with Figma via the Model Context Protocol, allowing LLM applications to access, manipulate, and track Figma files, components, and variables.
Last updated -
107
139
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-ключ для интеграции FigmaTAVILY_API_KEY: API-ключ для интеграции TavilyDUCKDUCKGO_API_KEY: API-ключ для интеграции DuckDuckGoBFL_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
Инструмент | Описание |
| Получить файл Figma по ключу |
| Получить определенные узлы из файла Figma |
| Получить изображения для узлов в файле Figma |
| Получить URL-адреса изображений, используемых в файле Figma |
| Получить комментарии к файлу Figma |
| Оставить комментарий к файлу Figma |
| Удалить комментарий из файла Figma |
| Получить проекты для команды |
| Получить файлы для проекта |
| Получить компоненты для команды |
| Получить компоненты из файла |
| Получить компонент по ключу |
| Получить наборы компонентов для команды |
| Получить стили для команды |
| Получить стили из файла |
| Получить стиль по ключу |
Инструменты XiaoyuZhouFM
Инструмент | Описание |
| Загрузите эпизод подкаста с XiaoyuZhouFM с возможностью автоматического преобразования m4a в mp3 |
Аудио инструменты
Инструмент | Описание |
| Получить длину аудиофайла в секундах |
| Получите транскрибированный текст из определенного временного диапазона в аудиофайле |
Инструменты памяти
Инструмент | Описание |
| Используйте инструмент, чтобы подумать о чем-то и добавить мысль в журнал |
| Получить текущий идентификатор сеанса |
| Сохраните воспоминание (краткое и подробное) в базе данных памяти. |
| Запрос воспоминаний из базы данных с помощью семантического поиска |
| Очистить все воспоминания в базе данных памяти |
Инструменты Markitdown
Инструмент | Описание |
| Конвертируйте любой файл в Markdown с помощью MarkItDown |
| Конвертируйте URL в Markdown с помощью MarkItDown |
Веб-инструменты
Инструмент | Описание |
| Получить HTML-контент из URL |
| Сохранить HTML из URL в файл |
| Поиск в Интернете с помощью Tavily (требуется ключ API) |
| Поиск в Интернете с помощью DuckDuckGo (требуется ключ API) |
Инструменты создания изображений Flux
Инструмент | Описание |
| Создайте изображение с помощью 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)Открыть запрос на извлечение
Лицензия
Данный проект лицензирован в соответствии с условиями лицензии, включенной в репозиторий.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Комплексный инструментарий, расширяющий возможности LLM с помощью протокола контекста модели, позволяя LLM взаимодействовать с внешними службами, включая операции командной строки, управление файлами, интеграцию Figma и обработку звука.
- Функции
- Установка
- Конфигурация
- Доступные инструменты
- Примеры использования
- Разработка
- Добавление новых инструментов
- Внося вклад
- Лицензия
Related Resources
Related MCP Servers
- AsecurityFlicenseAqualityA Model Context Protocol server that allows LLMs to interact with Python environments, enabling code execution, file operations, package management, and development workflows.Last updated -9
- -securityAlicense-qualityA toolkit for building Model Context Protocol servers and clients that provide standardized context for LLMs, allowing applications to expose resources, tools, and prompts through stdio or Streamable HTTP transports.Last updated -7,267,844MIT License
- -securityAlicense-qualityA command-line tool for creating and running Model Context Protocol servers that expose resources, tools, and prompts to LLM clients.Last updated -1831AGPL 3.0