DeBanK MCP 服务器

一个无状态模型上下文协议（MCP）服务器，用于通过与 DeBanK API 交互来获取区块链和 DeFi 数据。

概述

该项目实现了一个模型上下文协议（MCP）服务器，提供多种工具用于查询区块链数据，包括链、协议、代币、池和用户资产。该服务器使用 @modelcontextprotocol/sdk 构建，并利用 HTTP 可流式传输来提供高效现代的 API 接口。

服务器设计为完全无状态，每个请求独立处理，使其在生产环境中高度可扩展且稳定。

功能

• 无状态架构：每个请求创建一个新的服务器实例和传输
• 全面 DeFi 数据工具：访问链、协议、代币、池和用户数据
• 分页支持：所有返回列表的端点都支持分页
• 错误处理：强大的错误处理和报告

可用工具

先决条件

• Deno 1.35 或更高版本
• DeBanK API 访问密钥 - 获取一个

安装

1. 克隆仓库

git clone https://github.com/yourusername/debank-mcp-server.git
cd debank-mcp-server

2. 设置环境变量

export ACCESS_KEY=your_debank_api_key

运行服务器

使用以下命令启动服务器：

deno run --allow-net --allow-env main.ts

服务器将启动并侦听默认的 8080 端口。现在您可以向 http://localhost:8080/mcp 发送 MCP 请求。

MCP HTTP 可流式传输实现

该项目使用 Model Context Protocol SDK 中的 StreamableHTTPServerTransport 来处理 MCP 请求。每个请求都会创建一个新的服务器实例和传输，使服务完全无状态：

// 为每个请求创建新的服务器实例和传输
const server = createServer();
const transport = new StreamableHTTPServerTransport({
  sessionIdGenerator: () => randomUUID(),
});

// 连接到服务器
await server.connect(transport);

// 处理请求
await transport.handleRequest(req, res, req.body);

这种实现简化了部署和扩展，因为不需要在多个实例之间管理会话状态。

项目结构

├── main.ts                # 主服务器文件，包含 MCP 端点处理
├── deno.json              # Deno 配置文件
├── deno.lock              # 依赖锁定文件
├── tool/
│   ├── toolInfo.ts        # 工具定义
│   └── toolHandler.ts     # 工具处理器实现
└── README.md              # 本文件

配置

可以配置以下环境变量：

• ACCESS_KEY - 您的 DeBanK API 访问密钥
• PORT - （可选）服务器运行的端口（默认：8080）

贡献

欢迎贡献！请随意提交 Pull Request。

许可证

本项目在 MIT 许可证下，有关详细信息，请参阅 LICENSE 文件。

致谢

• 模型上下文协议
• DeBanK 团队