Delora MCP

Delora MCP

Delora API 的 MCP（Model Context Protocol）服务：提供跨链报价、支持的链、代币和工具。

安装

npm install

配置

将 env.example 复制为 .env 并进行调整：

变量	描述	默认值
DELORA_API_URL	Delora API 基础 URL	https://api.delora.build
DELORA_API_KEY	可选 API 密钥，会作为 x-api-key 转发给 Delora API	未设置
MCP_TRANSPORT	stdio 或 http	stdio
PORT	HTTP 服务端口（当 MCP_TRANSPORT=http 时）	3000
HOST	HTTP 绑定地址	0.0.0.0

设置 DELORA_API_KEY 后，MCP 服务会将其作为 x-api-key 请求头转发给 Delora API。在 HTTP 模式下，服务也会接受传入的 x-api-key 或 Authorization: Bearer ... 请求头，并将解析出的密钥转发到上游。对于 HTTP 请求，传入的请求头优先于 DELORA_API_KEY。对于 stdio，仍需通过 DELORA_API_KEY 提供密钥。

运行

Stdio（默认） — 用于通过 stdio 运行 Cursor/IDE MCP：

npm run dev
# or
npm run build && npm start

HTTP — 用于可流式传输的 HTTP（例如，通过反向代理访问）：

npm run dev:http
# or
npm run build && npm run start:http

服务监听地址为 http://0.0.0.0:3000/mcp。

Cursor 配置

Stdio：

{
  "mcpServers": {
    "delora": {
      "command": "node",
      "args": ["/path/to/delora-mcp/dist/index.js"]
    }
  }
}

可流式传输的 HTTP（例如，部署到 https://mcp.delora.build 后）：

{
  "mcpServers": {
    "delora": {
      "url": "https://mcp.delora.build/mcp",
      "transport": "streamable-http",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

如果 MCP 客户端支持自定义 HTTP 请求头，也可以使用 Authorization: Bearer YOUR_API_KEY 代替 x-api-key。

Docker

构建并运行：

docker build -t delora-mcp .
docker run -p 3000:3000 -e MCP_TRANSPORT=http delora-mcp

在域名后部署到生产环境（例如 mcp.delora.build）：使用 MCP_TRANSPORT=http 运行容器，并在前面配置 nginx/traefik（或其他反向代理）及 HTTPS；然后在 Cursor 中使用 URL https://mcp.delora.build/mcp 和 streamable-http。

API

• Delora API — 所有 /v1/* 端点（报价、链、代币、工具、代币）的基础 URL。

工具

工具	描述
get_instructions	返回本指南（工作流开始时调用）。
get_quote	GET /v1/quotes — 跨链报价。
get_chains	GET /v1/chains — 支持的链。
get_tools	GET /v1/tools — 可用工具。
get_tokens	GET /v1/tokens — 支持的代币。
get_token	GET /v1/token — 根据链和代币获取单个代币。