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
: Провайдер кошелька, которого вы хотите использовать.
Предпосылки
- 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
доступной во всей системе:
3. Сборка из исходного кода (для разработки или пользовательских модификаций):
- Клонируйте репозиторий:
- Установить зависимости:
- Сборка сервера: это компилирует код TypeScript в JavaScript в каталоге
dist
.Скриптprepare
также запускаетpnpm run build
, поэтому зависимости создаются при установке, если вы клонируете и запускаетеpnpm install
.
Конфигурация (переменные среды)
Этот сервер MCP может потребовать установки определенных переменных среды клиентом MCP, который его запускает. Обычно они настраиваются в определении сервера MCP клиента (например, в файле mcp.json
для Cursor или аналогичном для других клиентов).
- Любые необходимые переменные среды для поставщиков кошельков или ключей API.
Запуск сервера с клиентом MCP
Клиенты MCP (например, помощники AI, расширения IDE и т. д.) будут запускать этот сервер как фоновый процесс. Вам нужно настроить клиент, чтобы сообщить ему, как запустить ваш сервер.
Ниже приведен пример фрагмента конфигурации, который может использовать клиент MCP (например, в mcp_servers.json
или аналогичном файле конфигурации). В этом примере показано, как запустить сервер с использованием опубликованного пакета npm через pnpm dlx
.
Альтернатива при глобальной установке:
Если вы установили mcp-odos
глобально ( pnpm add -g mcp-odos
), вы можете упростить command
и args
:
command
: исполняемый файл для запуска.- Для
pnpm dlx
:"pnpm"
(с"dlx"
в качестве первого аргумента) - Для глобальной установки:
"mcp-odos"
- Для
args
: Массив аргументов для передачи команде.- Для
pnpm dlx
:["dlx", "mcp-odos"]
- Для глобальной установки:
[]
- Для
env
: Объект, содержащий переменные среды, которые должны быть установлены при запуске процесса сервера. Здесь вы предоставляете любые необходимые переменные среды.workingDirectory
: Обычно не требуется при использовании опубликованного пакета черезpnpm dlx
или глобальную установку, так как пакет должен правильно обрабатывать свои собственные пути. Если вы запускали из источника (node dist/index.js
), то установкаworkingDirectory
в корень проекта будет важна.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Сервер Model Context Protocol, который позволяет помощникам и приложениям на основе ИИ взаимодействовать с децентрализованными биржами (DEX), позволяя пользователям получать котировки на обмен токенов и выполнять транзакции обмена.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI agents to interact with 30+ Ethereum-compatible blockchain networks, providing services like token transfers, contract interactions, and ENS resolution through a unified interface.Last updated -28230252TypeScriptMIT License
- -securityFlicense-qualityA comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.Last updated -16TypeScript
- AsecurityAlicenseAqualityA server that allows AI models to interact with cryptocurrency exchange APIs through the Model Context Protocol, providing access to over 100 exchanges and their trading capabilities.Last updated -2047219TypeScriptMIT License
Hashkey MCP Serverofficial
-security-license-qualityA Model Context Protocol server that provides onchain tools for AI applications to interact with the Hashkey Network, enabling cryptocurrency transfers, smart contract deployment, and blockchain interactions.Last updated -TypeScriptMIT License