Мой MCP-сервер (для начинающих)

MCP (Model Context Protocol) сервер, созданный самостоятельно, с:

• Модулем собственного API-ключа и URL через файл .env

• Примеры инструментов: echo и call_my_api

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

• Готов к использованию прямо в VS Code (GitHub Copilot Chat)

1. Установка зависимостей

npm install

Related MCP server: mcp-server-demo

2. Создайте файл .env

Скопируйте .env.example в .env, затем заполните его своим API-ключом и URL:

Copy-Item .env.example .env

Содержимое .env:

MY_API_KEY=api-key-asli-kamu
MY_API_BASE_URL=https://api.contohkamu.com
MCP_SERVER_NAME=my-mcp-server

⚠️ Никогда не коммитьте файл .env в git. Он уже автоматически игнорируется через .gitignore.

3. Сборка проекта

npm run build

Эта команда компилирует TypeScript из src/ в JavaScript в build/.

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

MCP Inspector — это визуальный инструмент (браузер) для опробования ваших MCP-инструментов без необходимости в другом клиенте.

npm run inspector

Это запустит npx @modelcontextprotocol/inspector node build/index.js и откроет Inspector в браузере. Оттуда вы можете:

1. Нажать вкладку Tools

2. Выбрать инструмент echo или call_my_api

3. Заполнить параметры, нажать Run Tool и посмотреть результат

5. Использование прямо в VS Code

Файл .vscode/mcp.json уже подготовлен. Откройте Command Palette → MCP: List Servers → выберите my-mcp-server → Start Server. Этот сервер автоматически читает .env через envFile.

Структура проекта

├── .env                  # rahasia kamu (tidak di-commit)
├── .env.example          # contoh isi .env
├── .vscode/mcp.json      # konfigurasi MCP untuk VS Code
├── src/
│   ├── config.ts         # loader environment variable
│   ├── apiClient.ts      # modul pemanggilan API eksternal (pakai API key & URL)
│   └── index.ts          # server MCP utama + daftar tool
├── package.json
└── tsconfig.json

Добавление нового инструмента

Добавьте новый блок server.registerTool("имя_инструмента", { ... }, async (input) => { ... }) в src/index.ts, затем снова запустите npm run build.

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

• Ошибка "Environment variable ... belum diisi" → убедитесь, что .env существует и заполнен.

• Инструмент call_my_api не работает → проверьте, что MY_API_BASE_URL и MY_API_KEY указаны верно, и что конечная точка API поддерживает заголовок Authorization: Bearer <key>.

• Inspector не открывается → убедитесь, что вы сначала выполнили npm run build.