Домашнее задание MCP — Хост, два транспорта и навык

Этот проект удовлетворяет локальным частям задания без использования дополнительных фреймворков:

• CLI-агент с использованием Ollama qwen3.5:4b;

• MCP-хост, загружающий конфигурацию, объединяющий инструменты и маршрутизирующий вызовы;

• todo-сервер через stdio с 3 инструментами, 1 ресурсом и 1 подсказкой;

• тот же сервер через аутентифицированный локальный Streamable HTTP;

• прогрессивная загрузка навыков через use_skill;

• сохранение состояния, валидация, восстанавливаемые MCP-ошибки и интеграционные тесты.

Публичный хостинг намеренно не выполняется. См. PUBLIC_HTTP.md для точных шагов развертывания.

Требования

• Node.js 20+

• Ollama

• qwen3.5:4b: ollama pull qwen3.5:4b

Related MCP server: Personal OS MCP

Установка и проверка

npm install
npm test
npm run check

Запуск всего локально

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

Терминал 1 — запуск аутентифицированного HTTP-сервера:

export MCP_KEY="$(openssl rand -hex 32)"
echo "$MCP_KEY"   # copy this value for terminal 2
npm run server:http

Терминал 2 — убедитесь, что Ollama запущен, затем запустите агента:

export MCP_KEY="paste-the-same-value"
ollama serve      # omit if Ollama is already running

В другом терминале выполните:

export MCP_KEY="paste-the-same-value"
npm run agent

Попробуйте эти запросы:

Add "finish MCP homework" using the stdio todo server.
Add "record the demo" using the HTTP todo server.
Standup time — what should I work on today?

Последний запрос должен запустить use_skill("daily-plan"), затем вызвать оба MCP-сервера и вернуть Сегодня, Позже и Блокеры.

Тестирование с MCP Inspector

Stdio:

npx @modelcontextprotocol/inspector node src/servers/stdio.js

HTTP:

export MCP_KEY="a-local-test-key"
npm run server:http
npx @modelcontextprotocol/inspector

В Inspector выберите Streamable HTTP, используйте http://127.0.0.1:3000/mcp и добавьте заголовок Authorization: Bearer a-local-test-key. Проверьте:

1. add_task, list_tasks и complete_task отображаются и вызываются.

2. todo://list можно прочитать.

3. plan_my_day можно загрузить.

4. Завершение неизвестного ID возвращает isError: true.

Карта проекта

config.json                 agent/model/server configuration
skills/daily-plan/SKILL.md on-demand workflow
src/agent/                  MCP host, Ollama loop, and skill loader
src/todo/                   shared todo domain and MCP capabilities
src/servers/stdio.js        stdio entry point
src/servers/http.js         Streamable HTTP entry point
test/                       unit and protocol integration tests

Подтверждение оценивания

Демонстрация и чек-лист сдачи

Для короткой демонстрации на YouTube:

1. Покажите успешное выполнение npm test.

2. Покажите stdio-сервер в Inspector: инструменты, ресурс и подсказку.

3. Покажите HTTP-сервер, возвращающий 401 без ключа, а затем подключение с ключом.

4. В агенте добавьте одну задачу через каждый сервер.

5. Спросите "Время стендапа" и покажите автоматическую загрузку навыка с вызовами обоих серверов.

6. Кратко откройте config.json и SKILL.md и объясните маршрутизацию.

Отправьте ссылку на YouTube и исходный код в Moodle. Если вы позже развернете проект, также отправьте публичный URL /mcp и временный ключ для проверяющего.