Демонстрация потокового HTTP MCP TP5

Этот проект воссоздает цель демонстрации:

• MCP-сервер, предоставляющий два инструмента.

• Тестирование с помощью @modelcontextprotocol/inspector.

• Агент, совместимый с LangChain/LangGraph, использующий MCP через потоковый HTTP.

• Настройка ИИ-агента n8n с использованием MCP через потоковый HTTP.

Важное примечание по безопасности

Ключ OpenAI, вставленный в подсказку, был скомпрометирован в чате. Отозвите его и создайте новый ключ перед запуском агента. Поместите новый ключ в .env; не добавляйте его в репозиторий.

Настройка

Copy-Item .env.example .env
npm install

Отредактируйте .env и установите:

OPENAI_API_KEY=your_new_key

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

npm run server

Конечная точка MCP:

http://127.0.0.1:3000/mcp

Конечная точка проверки работоспособности:

http://127.0.0.1:3000/health

Тестирование с помощью MCP Inspector

В одном терминале оставьте сервер запущенным:

npm run server

В другом терминале выведите список инструментов с помощью CLI Inspector:

npm run inspector:list-tools

В Windows текущий CLI Inspector может вывести правильный JSON-ответ, а затем завершиться с ошибкой утверждения Node/libuv. Если вы видите JSON tools, содержащий calculate и text_stats, значит, сам вызов MCP прошел успешно.

Вызовите инструмент с помощью CLI Inspector:

npx --yes @modelcontextprotocol/inspector --cli http://127.0.0.1:3000/mcp --transport http --method tools/call --tool-name calculate --tool-arg operation=add --tool-arg "numbers=[2,3,4]"

Вы также можете открыть пользовательский интерфейс Inspector:

npm run inspector

Затем выберите:

Transport: Streamable HTTP
URL: http://127.0.0.1:3000/mcp

Локальное дымовое тестирование

npm run smoke

Это выводит список инструментов MCP и вызывает calculate.

Агент LangChain

Убедитесь, что сервер запущен и .env содержит действительный обновленный OPENAI_API_KEY.

npm run agent

Пользовательская подсказка:

npm run agent -- "Calcule 42 / 6 puis analyse le texte: Bonjour depuis MCP."

Агент n8n

Следуйте инструкциям в docs/n8n-agent.md.

Конфигурация инструмента клиента n8n MCP:

Endpoint: http://127.0.0.1:3000/mcp
Server Transport: HTTP Streamable
Authentication: None
Tools to Include: All