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 servicio get-quote .
• walletProvider : el proveedor de billetera que desea utilizar.

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:

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 .

Alternativa si se instala globalmente:

Si ha instalado mcp-odos globalmente ( pnpm add -g mcp-odos ), puede simplificar el command y args :

• 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.