MCP-ODOS
MCP-ODOS: Servidor de protocolo de contexto de modelo para intercambios descentralizados
Este proyecto implementa un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con plataformas de intercambio descentralizadas (DEX). Permite a los clientes compatibles con MCP (como asistentes de IA, extensiones de IDE o aplicaciones personalizadas) acceder a funcionalidades como la obtención de cotizaciones y la ejecución de swaps.
Este servidor está construido utilizando TypeScript y fastmcp .
Características (Herramientas MCP)
El servidor expone las siguientes herramientas que los clientes MCP pueden utilizar:
ODOS_GET_QUOTE: Obtener una cotización para un intercambio.Parámetros:
chainId(número),sellToken(cadena),buyToken(cadena),sellAmount(cadena)
ODOS_EXECUTE_SWAP: Ejecutar un intercambio.Parámetros:
chainId(número),sellToken(cadena),buyToken(cadena),sellAmount(cadena),quote(cadena),walletProvider(cadena)
Desglose de parámetros
chainId: El ID de la cadena del DEX.sellToken: El token que quieres vender.buyToken: El token que quieres comprar.sellAmount: la cantidad de tokens que desea vender.quote: La cotización que obtuvo del servicioget-quote.walletProvider: el proveedor de billetera que desea utilizar.
Related MCP server: CCXT MCP Server
Prerrequisitos
Node.js (se recomienda v18 o más reciente)
pnpm (Ver https://pnpm.io/installation )
Instalación
Hay algunas formas de utilizar mcp-odos :
1. Uso de pnpm dlx (recomendado para la mayoría de las configuraciones de cliente MCP):
Puede ejecutar el servidor directamente con pnpm dlx sin necesidad de una instalación global. Esta suele ser la forma más sencilla de integrarse con clientes MCP. Consulte la sección "Ejecutar el servidor con un cliente MCP" para ver ejemplos. ( pnpm dlx es el equivalente de npx en pnpm).
2. Instalación global desde npm (a través de pnpm):
Instale el paquete globalmente para que el comando mcp-odos esté disponible en todo el sistema:
pnpm add -g mcp-odos3. Construcción desde la fuente (para desarrollo o modificaciones personalizadas):
Clonar el repositorio:
git clone https://github.com/IQAIcom/mcp-odos.git cd mcp-odosInstalar dependencias:
pnpm installConstruir el servidor: Esto compila el código TypeScript a JavaScript en el directorio
dist.pnpm run buildEl script
preparetambién ejecutapnpm run build, por lo que las dependencias se crean durante la instalación si clona y ejecutapnpm install.
Configuración (variables de entorno)
Este servidor MCP puede requerir que el cliente MCP que lo ejecuta configure ciertas variables de entorno. Estas suelen configurarse en la definición del servidor MCP del cliente (por ejemplo, en un archivo mcp.json para Cursor o similar para otros clientes).
Cualquier variable de entorno necesaria para proveedores de billetera o claves API.
Ejecución del servidor con un cliente MCP
Los clientes MCP (como asistentes de IA, extensiones IDE, etc.) ejecutarán este servidor en segundo plano. Debe configurar el cliente para indicarle cómo iniciar el servidor.
A continuación se muestra un fragmento de configuración de ejemplo que un cliente MCP podría usar (por ejemplo, en un archivo de configuración mcp_servers.json o similar). Este ejemplo muestra cómo ejecutar el servidor usando el paquete npm publicado mediante pnpm dlx .
{
"mcpServers": {
"iq-odos-mcp-server": {
"command": "pnpm",
"args": ["dlx", "mcp-odos"],
"env": {
"WALLET_PRIVATE_KEY": "your_wallet_private_key_here"
}
}
}
}Alternativa si se instala globalmente:
Si ha instalado mcp-odos globalmente ( pnpm add -g mcp-odos ), puede simplificar el command y args :
{
"mcpServers": {
"iq-odos-mcp-server": {
"command": "mcp-odos",
"args": [],
"env": {
"WALLET_PRIVATE_KEY": "your_wallet_private_key_here"
}
}
}
}command: El ejecutable a ejecutar.Para
pnpm dlx:"pnpm"(con"dlx"como primer argumento)Para instalación global:
"mcp-odos"
args: una matriz de argumentos para pasar al comando.Para
pnpm dlx:["dlx", "mcp-odos"]Para instalación global:
[]
env: Un objeto que contiene las variables de entorno que se configurarán al iniciar el proceso del servidor. Aquí se proporcionan las variables de entorno necesarias.workingDirectory: Generalmente no es necesario al usar el paquete publicado mediantepnpm dlxo una instalación global, ya que el paquete debería gestionar sus propias rutas correctamente. Si se ejecuta desde el código fuente (node dist/index.js), sería importante configurarworkingDirectoryen la raíz del proyecto.
Available Tools
3 toolsODOS_GET_CHAIN_IDA
Get the chain ID for a given chain name
Inputs: chain (required).
ODOS_GET_QUOTEB
Get a quote for a swap or exchange operation
Inputs: fromToken (required), toToken (required), amount (required), chain, +1 more.
ODOS_SWAPC
Execute a swap transaction
Inputs: fromToken (required), toToken (required), amount (required), chain, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a distinct step in the swap process: chain ID lookup, quote retrieval, and execution. No ambiguity or overlap exists.
All tools use a consistent ODOS_ prefix followed by clear verb_noun patterns (GET_CHAIN_ID, GET_QUOTE, SWAP), making them predictable.
With 3 tools, the server is well-scoped for the core swap workflow without unnecessary bloat or deficiency.
The tools cover the essential swap steps but lack a token approval tool, which is commonly required for many swaps, creating a potential gap.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Multi-aggregator swap router for AI agents on Base. 10 bps fee. MCP-native, non-custodial.
A Model Context Protocol server for Wix AI tools
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server enabling AI agents to interact with the Solana blockchain for DeFi operations like checking balances, transferring tokens, executing swaps, and fetching price data.45 npm21MIT
- AlicenseBqualityDmaintenanceA 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.20486 npm95MIT
- FlicenseAqualityDmaintenanceA Model Context Protocol server that enables AI agents to autonomously execute cross-chain trading operations on Paloma DEX across seven EVM chains including Ethereum, Arbitrum, and Polygon.21-
- AlicenseNot gradedqualityNot gradedmaintenanceA comprehensive Model Context Protocol server that enables AI agents to interact with BNB Chain, opBNB, and other EVM networks through natural language. It provides tools for DeFi trading, DEX swaps, smart contract deployment, token operations, security analysis, and market data across multiple blockchain networks.41 npm-