MCP Добавить сервер

Минимальный сервер Model Context Protocol (MCP), который предоставляет простой инструмент add(a, b) . Этот проект служит базовым примером реализации сервера MCP.

Функции

• Реализует сервер, совместимый с протоколом контекста модели.

• Предоставляет один инструмент: add(a, b) , который возвращает сумму двух чисел.

Related MCP server: Basic Math MCP Server

Предпосылки

• Node.js (рекомендуется версия 18.xx или выше)

• npm (входит в состав Node.js)

Установка

1. Клонируйте репозиторий:

   git clone <你的仓库URL> # 当你推送到 GitHub 后，替换这里的 URL
   cd mcp-add-server

2. Установите зависимости:

   npm install

Использование

Существует несколько способов запуска mcp-add-server :

1. Использование npx (рекомендуется для большинства пользователей):

Если у вас установлены Node.js и npm, вы можете запустить сервер напрямую, без клонирования или глобальной установки:

npx mcp-add-server

Эта команда загрузит последнюю версию mcp-add-server (если она еще не кэширована) и выполнит ее.

2. Запуск из клонированного репозитория:

После клонирования репозитория и установки зависимостей (см. Установка ):

npm start

При этом используется start скрипт, определенный в package.json .

3. Глобальная установка (для частого использования или разработки):

Вы можете установить пакет глобально:

npm install -g .  # From the cloned repository directory
# or once published to npm:
# npm install -g mcp-add-server

Затем вы можете запустить его из любого каталога:

mcp-add-server

4. Локальное связывание для разработки: В корневом каталоге проекта запустите npm link . Это сделает команду mcp-add-server доступной глобально, указав на ваши локальные файлы проекта.

# In project directory
npm link

# Then, in any directory:
mcp-add-server

После запуска сервера (независимо от используемого метода) он будет доступен клиентам MCP.

Пример вызова инструмента (концептуальный)

Клиент MCP может вызвать инструмент add следующим образом (конкретика зависит от реализации клиента):

{
  "tool_name": "add",
  "arguments": {
    "a": 5,
    "b": 3
  }
}

Сервер ответит:

{
  "result": 8
}

Проведение тестов

(Когда тесты будут добавлены, опишите здесь, как их запускать)

npm test

(В настоящее время npm test выводит сообщение «Ошибка: тест не указан». Обновите test скрипт в package.json при добавлении тестов.)

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

mcp-add-server/
├── .git/               # Git directory
├── .gitignore          # Specifies intentionally untracked files that Git should ignore
├── .cursor/            # Cursor specific files (if any)
├── node_modules/       # Project dependencies
├── src/                # Source code
│   └── server.js       # Main server logic
├── bin.js              # Executable for the server
├── LICENSE             # Project license
├── package-lock.json   # Records exact versions of dependencies
├── package.json        # Project metadata and dependencies
└── README.md           # This file

Внося вклад

Вклады приветствуются! Не стесняйтесь отправлять запрос на включение или открывать проблему.

Лицензия

Данный проект лицензирован в соответствии с лицензией MIT .