deBridge

Integração MCP deBridge

Integração MCP do deBridge para agentes de IA — swaps cross-chain e same-chain, estimativa de taxas e execução de negociações nas principais redes blockchain.

O endpoint MCP hospedado está disponível em agents.debridge.com. Este pacote npm é um cliente proxy leve para agentes que exigem um processo local stdio ou HTTP.

https://github.com/user-attachments/assets/8ebe88ff-db3c-455e-9efb-50389e4bf5bd

Conectando-se ao deBridge MCP

Recomendado: Conexão direta (Streamable HTTP)

Conecte seu agente diretamente ao endpoint hospedado — sem instalação, sem processo local:

https://agents.debridge.com/mcp

Este é um endpoint MCP Streamable HTTP. Ele expõe ferramentas (get_instructions, search_tokens, get_supported_chains, create_tx, transaction_same_chain_swap), habilidades de fluxo de trabalho via recursos MCP e uma visão geral llms.txt. Ferramentas e habilidades são mantidas no repositório debridge-finance/debridge-skills.

Configuração genérica de Streamable HTTP:

"debridge": {
  "type": "streamable-http",
  "url": "https://agents.debridge.com/mcp"
}

claude mcp add debridge --transport http https://agents.debridge.com/mcp

claude mcp list

{
  "mcpServers": {
    "debridge": {
      "url": "https://agents.debridge.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "debridge": {
      "type": "streamable-http",
      "url": "https://agents.debridge.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "debridge": {
      "type": "streamable-http",
      "url": "https://agents.debridge.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "debridge": {
      "type": "streamable-http",
      "url": "https://agents.debridge.com/mcp"
    }
  }
}

{
  "mcpServers": [
    {
      "name": "debridge",
      "transport": "streamable-http",
      "url": "https://agents.debridge.com/mcp"
    }
  ]
}

{
  "context_servers": {
    "debridge": {
      "transport": "streamable-http",
      "url": "https://agents.debridge.com/mcp"
    }
  }
}

openclaw plugins install mcp-adapter

{
  "plugins": {
    "entries": {
      "mcp-adapter": {
        "enabled": true,
        "config": {
          "servers": [
            {
              "name": "debridge",
              "transport": "streamable-http",
              "url": "https://agents.debridge.com/mcp"
            }
          ]
        }
      }
    }
  }
}

Alternativa: Execute um proxy local

Alguns frameworks de agentes suportam apenas transporte stdio e não conseguem se conectar diretamente a um endpoint HTTP remoto. Este pacote npm preenche essa lacuna — ele executa um processo MCP local que faz proxy transparente de todas as solicitações para https://agents.debridge.com/mcp.

Ferramentas e recursos não são implementados localmente. Eles são descobertos dinamicamente do endpoint upstream na inicialização (stdio) ou encaminhados por solicitação (HTTP), portanto, quaisquer alterações no MCPd hospedado são refletidas automaticamente sem atualizar o pacote.

Como o proxy funciona

• Modo stdio (padrão): Abre uma conexão de cliente MCP de longa duração com o MCPd upstream via StreamableHTTPClientTransport. Cria um Server local com StdioServerTransport que espelha as capacidades upstream e encaminha tools/list, tools/call, resources/list, resources/read e resources/templates/list para o upstream.

• Modo HTTP (MCP_TRANSPORT=http): Proxy reverso HTTP transparente via Express. Encaminha solicitações JSON-RPC brutas e fluxos de resposta SSE para o MCPd upstream, passando pelos cabeçalhos Mcp-Session-Id para continuidade de sessão.

npx (stdio)

npx -y @debridge-finance/debridge-mcp@latest

Configuração stdio:

"debridge": {
  "type": "stdio",
  "command": "npx",
  "args": ["-y", "@debridge-finance/debridge-mcp@latest"]
}

claude mcp add debridge npx -- -y @debridge-finance/debridge-mcp@latest

{
  "mcpServers": {
    "debridge": {
      "command": "npx",
      "args": ["-y", "@debridge-finance/debridge-mcp@latest"]
    }
  }
}

Docker (proxy HTTP)

docker build -t debridge-mcp .
docker run -p 3000:3000 debridge-mcp

Em seguida, conecte seu agente ao http://localhost:3000/mcp usando as configurações de Streamable HTTP acima.

Variáveis de Ambiente

Desenvolvimento

# Install dependencies
npm install

# Run in dev mode (stdio proxy)
npm run dev

# Run in dev mode (HTTP proxy)
npm run dev:http

# Test with MCP Inspector
npm run inspect

# Run tests
npm test

Links

Licença

MIT, Copyright 2026 deBridge