🏠 Главная › user guide › mcp fastmcp

{/ Эта страница автоматически создается на основе файла SKILL.md навыка с помощью сайта site/scripts/generate-skill-docs.py. Редактируйте исходный код SKILL.md, а не эту страницу. /}

Фастмкп

Создавайте, тестируйте, проверяйте, устанавливайте и развертывайте серверы MCP с помощью FastMCP на Python. Используйте при создании нового сервера MCP, упаковке API или базы данных в качестве инструментов MCP, предоставлении ресурсов или подсказок или подготовке сервера FastMCP для развертывания Claude Code, Cursor или HTTP.

Метаданные навыков
Источник Необязательно — установите с помощью hermesskills installofficial/mcp/fastmcp
Путь необязательные навыки/mcp/fastmcp
Версия 1.0.0
Автор Агент Гермес
Лицензия Массачусетский технологический институт
Платформы Linux, MacOS, Windows
Теги MCP, FastMCP, Python, Инструменты, Ресурсы, Подсказки, Развертывание
Сопутствующие навыки native-mcp, mcpor

Ссылка: полная версия SKILL.md:::информация

Ниже приведено полное определение навыка, которое Гермес загружает при активации этого навыка. Это то, что агент видит в качестве инструкций, когда навык активен.

ФастMCP

Создавайте серверы MCP на Python с помощью FastMCP, проверяйте их локально, устанавливайте в клиенты MCP и развертывайте в качестве конечных точек HTTP.

Когда использовать

Используйте этот навык, когда задача состоит в том, чтобы:

— создать новый сервер MCP на Python - обернуть API, базу данных, интерфейс командной строки или рабочий процесс обработки файлов инструментами MCP. - предоставлять ресурсы или подсказки в дополнение к инструментам - провести дымовое тестирование сервера с помощью FastMCP CLI перед подключением его к Hermes или другому клиенту. - установить сервер в Claude Code, Claude Desktop, Cursor или аналогичный клиент MCP. - подготовить репозиторий сервера FastMCP для развертывания HTTP.

Используйте «native-mcp», если сервер уже существует и его нужно только подключить к Hermes. Используйте mcporter, когда целью является специальный доступ CLI к существующему серверу MCP вместо его создания.

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

Сначала установите FastMCP в рабочую среду:

pip install fastmcp
fastmcp version

Для шаблона API установите httpx, если он еще не установлен:

pip install httpx

Включенные файлы

Шаблоны

Скрипты

Ссылки

— references/fastmcp-cli.md — рабочий процесс FastMCP CLI, цели установки и проверки развертывания.

Рабочий процесс

1. Выберите наименьшую жизнеспособную форму сервера

Сначала выберите самую узкую полезную площадь поверхности:

Предпочитайте тонкий сервер с хорошими именами, строками документации и схемами большему серверу с неясными инструментами.

2. Леска из шаблона

Скопируйте шаблон напрямую или воспользуйтесь помощником по созданию шаблонов:

python ~/.hermes/skills/mcp/fastmcp/scripts/scaffold_fastmcp.py \
  --template api_wrapper \
  --name "Acme API" \
  --output./acme_server.py

Доступные шаблоны:

python ~/.hermes/skills/mcp/fastmcp/scripts/scaffold_fastmcp.py --list

При копировании вручную замените __SERVER_NAME__ реальным именем сервера.

3. Сначала внедрите инструменты

Прежде чем добавлять ресурсы или подсказки, начните с функций @mcp.tool.

Правила оформления инструмента:

Примеры хороших инструментов:

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

4. Добавляйте ресурсы и подсказки только тогда, когда они помогают

Добавьте @mcp.resource, если клиент получает выгоду от получения стабильного контента, доступного только для чтения, такого как схемы, документы политики или сгенерированные отчеты.

Добавьте @mcp.prompt, если сервер должен предоставить повторно используемый шаблон приглашения для известного рабочего процесса.

Не превращайте каждый документ в подсказку. Предпочитаю:

5. Протестируйте сервер перед его куда-либо интеграцией

Используйте FastMCP CLI для локальной проверки:

fastmcp inspect acme_server.py:mcp
fastmcp list acme_server.py --json
fastmcp call acme_server.py search_resources query=router limit=5 --json

Для быстрой итеративной отладки запустите сервер локально:

fastmcp run acme_server.py:mcp

Чтобы протестировать HTTP-транспорт локально:

fastmcp run acme_server.py:mcp --transport http --host 127.0.0.1 --port 8000
fastmcp list http://127.0.0.1:8000/mcp --json
fastmcp call http://127.0.0.1:8000/mcp search_resources query=router --json

Всегда запускайте хотя бы один реальный «вызов fastmcp» для каждого нового инструмента, прежде чем утверждать, что сервер работает.

6. Установка на клиент после прохождения локальной проверки

FastMCP может зарегистрировать сервер с поддерживаемыми клиентами MCP:

fastmcp install claude-code acme_server.py
fastmcp install claude-desktop acme_server.py
fastmcp install cursor acme_server.py -e.

Используйте fastmcp Discover для проверки именованных серверов MCP, уже настроенных на компьютере.

Когда целью является интеграция Hermes, либо:

7. Развертывание после стабилизации локального контракта

Для управляемого хостинга Prefect Horizon — это наиболее прямой путь к документам FastMCP. Перед развертыванием:

fastmcp inspect acme_server.py:mcp

Убедитесь, что репо содержит:

— файл Python с серверным объектом FastMCP. - requirements.txt или pyproject.toml - любая документация по переменным среды, необходимая для развертывания.

Для общего HTTP-хостинга сначала проверьте HTTP-транспорт локально, а затем разверните его на любой Python-совместимой платформе, которая может предоставить порт сервера.

Общие шаблоны

Шаблон оболочки API

Используйте при предоставлении REST или HTTP API в качестве инструментов MCP.

Рекомендуемый первый кусочек:

Замечания по реализации:

Начните с шаблонов/api_wrapper.py.

Шаблон базы данных

Используйте при предоставлении возможностей безопасного запроса и проверки.

Рекомендуемый первый кусочек:

Замечания по реализации:

Начните с templates/database_server.py.

Шаблон файлового процессора

Используйте, когда серверу необходимо проверять или преобразовывать файлы по требованию.

Рекомендуемый первый кусочек:

Замечания по реализации:

Начните с templates/file_processor.py.

Панель качества

Прежде чем передать сервер FastMCP, проверьте все следующее:

Устранение неполадок

Команда FastMCP отсутствует

Установите пакет в активную среду:

pip install fastmcp
fastmcp version

fastmcp проверить не удалось

Проверьте это:

Инструмент работает на Python, но не через CLI

Запустить:

fastmcp list server.py --json
fastmcp call server.py your_tool_name --json

Обычно это приводит к несоответствию имен, отсутствию обязательных аргументов или несериализуемым возвращаемым значениям.

Гермес не видит развернутый сервер

Часть по созданию сервера может быть правильной, а вот конфигурация Hermes — нет. Загрузите навык native-mcp и настройте сервер в ~/.hermes/config.yaml, затем перезапустите Hermes.

Ссылки

Подробную информацию о CLI, целях установки и проверках развертывания можно найти в references/fastmcp-cli.md.