Первый MCP-инструмент на Python: сервер и проверка без модели
Небольшой сервер на самостоятельном пакете FastMCP считает слова; отдельно проверяются функция и MCP-вызов.
Сделаем инструмент, который считает слова в переданном тексте. Он не читает файлы, не обращается к внешним API и не требует ключа модели. Такой пример позволяет раздельно проверить вычисление и вызов через MCP до подключения рабочих данных.
Пакет и окружение
Используется самостоятельный пакет fastmcp с импортом from fastmcp import FastMCP. Не смешивайте его с API другого пакета mcp. В отдельном учебном окружении документация предлагает pip install fastmcp или uv add fastmcp; после установки выполните fastmcp version и сохраните фактическую версию. Не обновляйте рабочий сервер этим примером без отдельной проверки совместимости.
Сервер в одном файле
Создайте text_server.py:
from fastmcp import FastMCP
mcp = FastMCP("text-stats")
def calculate_stats(text: str) -> dict[str, int]:
words = text.split()
return {"words": len(words), "unique_words": len({w.casefold() for w in words})}
@mcp.tool
def text_stats(text: str) -> dict[str, int]:
"""Посчитать слова, разделённые пробельными символами."""
return calculate_stats(text)
if __name__ == "__main__":
mcp.run()Декоратор регистрирует инструмент; mcp.run() запускает локальный stdio-сервер. Такой процесс ожидает сообщения клиента, а не текст в обычном диалоге терминала. Это схема из официального quickstart, адаптированная к функции подсчёта; не HTTP endpoint.
Проверьте две разные вещи
Создайте рядом check_text_server.py. Первые assertions проверяют расчёт; Client(mcp) проверяет обнаружение и вызов инструмента в памяти без сетевого слушателя.
import asyncio
from fastmcp import Client
from text_server import calculate_stats, mcp
assert calculate_stats("") == {"words": 0, "unique_words": 0}
assert calculate_stats("Мир мир") == {"words": 2, "unique_words": 1}
async def main():
async with Client(mcp) as client:
tools = await client.list_tools()
assert "text_stats" in {tool.name for tool in tools}
result = await client.call_tool("text_stats", {"text": "Мир мир"})
assert result.data == {"words": 2, "unique_words": 1}
print("Проверены расчёт и MCP-вызов")
asyncio.run(main())Запустите python check_text_server.py из каталога с обоими файлами и установленным FastMCP. Успех проверки в памяти не подтверждает установку в Cursor или работу stdio-процесса: это отдельные последующие проверки.
Границы примера
Слова определяются по пробельным разделителям без лингвистического анализа; пунктуация остаётся частью слова. Модель не используется. Для следующего шага подключайте свой файл через поддержанный клиентом локальный транспорт, сохраняя абсолютный путь и окружение. HTTP-деплой, авторизация и публичное размещение сюда не входят.
Редакционная основа сверена с документацией FastMCP 15 октября 2026 года. Локальный запуск проверочного MCP-вызова указываем только в отдельном протоколе после фактического smoke; читатель должен проверить его в собственном окружении.