MCP-ODOS: сервер контекстного протокола модели для децентрализованных обменов

Этот проект реализует сервер Model Context Protocol (MCP) для взаимодействия с децентрализованными биржами (DEX). Он позволяет MCP-совместимым клиентам (таким как помощники AI, расширения IDE или пользовательские приложения) получать доступ к таким функциям, как получение котировок для свопов и выполнение свопов.

Этот сервер создан с использованием TypeScript и fastmcp .

Возможности (инструменты MCP)

Сервер предоставляет следующие инструменты, которые могут использовать клиенты MCP:

• ODOS_GET_QUOTE : Получить котировку для обмена.

  • Параметры: chainId (число), sellToken (строка), buyToken (строка), sellAmount (строка)

• ODOS_EXECUTE_SWAP : Выполнить замену.

  • Параметры: chainId (число), sellToken (строка), buyToken (строка), sellAmount (строка), quote (строка), walletProvider (строка)

Разбивка параметров

• chainId : идентификатор цепочки DEX.

• sellToken : токен, который вы хотите продать.

• buyToken : токен, который вы хотите купить.

• sellAmount : Количество токенов, которое вы хотите продать.

• quote : Цену, которую вы получили от сервиса get-quote .

• walletProvider : Провайдер кошелька, которого вы хотите использовать.

Related MCP server: CCXT MCP Server

Предпосылки

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

• pnpm (см. https://pnpm.io/installation )

Установка

Есть несколько способов использовать mcp-odos :

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

Вы можете запустить сервер напрямую с помощью pnpm dlx без необходимости глобальной установки. Это часто самый простой способ интеграции с клиентами MCP. Смотрите раздел «Запуск сервера с клиентом MCP» для примеров. ( pnpm dlx — это эквивалент npx в pnpm)

2. Глобальная установка из npm (через pnpm):

Установите пакет глобально, чтобы сделать команду mcp-odos доступной во всей системе:

pnpm add -g mcp-odos

3. Сборка из исходного кода (для разработки или пользовательских модификаций):

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

   git clone https://github.com/IQAIcom/mcp-odos.git
   cd mcp-odos

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

   pnpm install

3. Сборка сервера: это компилирует код TypeScript в JavaScript в каталоге dist .

   pnpm run build

   Скрипт prepare также запускает pnpm run build , поэтому зависимости создаются при установке, если вы клонируете и запускаете pnpm install .

Конфигурация (переменные среды)

Этот сервер MCP может потребовать установки определенных переменных среды клиентом MCP, который его запускает. Обычно они настраиваются в определении сервера MCP клиента (например, в файле mcp.json для Cursor или аналогичном для других клиентов).

• Любые необходимые переменные среды для поставщиков кошельков или ключей API.

Запуск сервера с клиентом MCP

Клиенты MCP (например, помощники AI, расширения IDE и т. д.) будут запускать этот сервер как фоновый процесс. Вам нужно настроить клиент, чтобы сообщить ему, как запустить ваш сервер.

Ниже приведен пример фрагмента конфигурации, который может использовать клиент MCP (например, в mcp_servers.json или аналогичном файле конфигурации). В этом примере показано, как запустить сервер с использованием опубликованного пакета npm через pnpm dlx .

{
  "mcpServers": {
    "iq-odos-mcp-server": {
      "command": "pnpm",
      "args": ["dlx", "mcp-odos"],
      "env": {
        "WALLET_PRIVATE_KEY": "your_wallet_private_key_here"
      }
    }
  }
}

Альтернатива при глобальной установке:

Если вы установили mcp-odos глобально ( pnpm add -g mcp-odos ), вы можете упростить command и args :

{
  "mcpServers": {
    "iq-odos-mcp-server": {
      "command": "mcp-odos",
      "args": [],
      "env": {
        "WALLET_PRIVATE_KEY": "your_wallet_private_key_here"
      }
    }
  }
}

• command : исполняемый файл для запуска.

  • Для pnpm dlx : "pnpm" (с "dlx" в качестве первого аргумента)

  • Для глобальной установки: "mcp-odos"

• args : Массив аргументов для передачи команде.

  • Для pnpm dlx : ["dlx", "mcp-odos"]

  • Для глобальной установки: []

• env : Объект, содержащий переменные среды, которые должны быть установлены при запуске процесса сервера. Здесь вы предоставляете любые необходимые переменные среды.

• workingDirectory : Обычно не требуется при использовании опубликованного пакета через pnpm dlx или глобальную установку, так как пакет должен правильно обрабатывать свои собственные пути. Если вы запускали из источника ( node dist/index.js ), то установка workingDirectory в корень проекта будет важна.