Skip to main content
Glama

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 servicio get-quote .

  • walletProvider : el proveedor de billetera que desea utilizar.

Related MCP server: CCXT MCP Server

Prerrequisitos

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-odos

3. Construcción desde la fuente (para desarrollo o modificaciones personalizadas):

  1. Clonar el repositorio:

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

    pnpm install
  3. Construir el servidor: Esto compila el código TypeScript a JavaScript en el directorio dist .

    pnpm run build

    El script prepare también ejecuta pnpm run build , por lo que las dependencias se crean durante la instalación si clona y ejecuta pnpm 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 mediante pnpm dlx o 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 configurar workingDirectory en la raíz del proyecto.

Available Tools

3 tools
ODOS_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

    A3.5/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool targets a distinct step in the swap process: chain ID lookup, quote retrieval, and execution. No ambiguity or overlap exists.

    Naming Consistency5/5

    All tools use a consistent ODOS_ prefix followed by clear verb_noun patterns (GET_CHAIN_ID, GET_QUOTE, SWAP), making them predictable.

    Tool Count5/5

    With 3 tools, the server is well-scoped for the core swap workflow without unnecessary bloat or deficiency.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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 npm
      21
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      A 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
      -

    Appeared in Searches