Интеграция MCP-сервера — практическое задание

Каркас для подготовительного упражнения CCA-F из 2.4 Интеграция MCP-сервера. Здесь ничего не решено — каждая задача ниже содержит TODO, который вам нужно заполнить.

Контрольный список задач

• 1. Конфигурация на уровне проекта — в .mcp.json есть запись сервера github (command/args). Замените её на любой другой сервер сообщества, если не GitHub.

• 2. Разворачивание переменных окружения — запись github ссылается на ${GITHUB_TOKEN} вместо жёстко заданного учётного данного. Скопируйте .env.example в .env и укажите настоящий токен.

• 3. Конфигурация на уровне пользователя — намеренно не создана здесь, поскольку ~/.claude.json находится вне проекта и является личным для вашей машины. Шаблон и шаги: docs/user-level-config.md.

• 4. Предоставьте ресурс MCP — в src/server.ts есть заглушка ресурса catalogue://TODO. Замените её на реальный каталог контента (например, схему БД или иерархию документов) с правильным URI, именем, описанием и mimeType.

• 5. Улучшите описания инструментов — в том же файле example_tool имеет описание-заглушку. Напишите 3-5 предложений, охватывающих возможности, вывод, вариант использования и сравнение со встроенной альтернативой.

Related MCP server: MCP Inspector Server

Настройка

npm install
npm run dev        # starts the stdio server directly
npm run inspect     # opens MCP Inspector against the server for manual testing

Структура

.mcp.json                   Task 1 & 2 — project-level server config
.env.example                Task 2 — template for the secret .mcp.json expands
docs/user-level-config.md   Task 3 — template + steps for ~/.claude.json
src/server.ts                Task 4 & 5 — custom MCP server with resource/tool stubs