my-mcp-server

Учебный и экспериментальный проект для создания сервера MCP (Model Context Protocol) на TypeScript. Он демонстрирует, как предоставлять инструменты и ресурсы AI-агентам и языковым моделям через транспорт stdio.

Сервер управляет простой базой данных пользователей (хранящейся в локальном JSON-файле) и предоставляет конечные точки, которые AI-агент может вызывать для чтения или создания записей пользователей.

Возможности

• Инструмент — my-create-tool: Создаёт нового пользователя, принимая поля name, address, email и phone, и сохраняет запись в src/users.json.

• Ресурс — users://all: Возвращает полный список пользователей из имитированной базы данных в формате JSON.

• Ресурс — users://{userId}/profile: Возвращает профиль конкретного пользователя по идентификатору userId.

Related MCP server: FastMCP Example Server

Предварительные требования

• Node.js версии 18 или новее

• npm версии 9 или новее

Установка

npm install

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

Режим разработки (с использованием tsx, без этапа сборки)

npm run server:dev

Сборка и запуск скомпилированного кода

npm run server:build   # compiles TypeScript → JavaScript
node dist/server.js    # run the compiled server

Режим наблюдения (автоматическая перекомпиляция при изменениях)

npm run server:build:watch

Проверка с помощью MCP Inspector UI

Инспектор MCP позволяет интерактивно вызывать инструменты и просматривать ресурсы в браузерном интерфейсе:

npm run server:inspect

Примечание: server:inspect устанавливает DANGEROUSLY_OMIT_AUTH=true — используйте это только для локальной разработки.

Загрузка сервера MCP в средах агентов

CLI агента (например, Claude Code CLI)

Наличие файла .mcp.json должно быть автоматически обнаружено агентом с предложением загрузить сервер. В противном случае это просто конфигурация сервера MCP, которую необходимо добавить в общую конфигурацию вместе с другими серверами.

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

my-mcp-server/
├── src/
│   ├── server.ts      # MCP server entry point (tools & resources)
│   └── users.json     # Mock user database (read/written at runtime)
├── package.json
└── tsconfig.json

Технологический стек

Лицензия

ISC