Debank

🚀 DeBanK MCP 服務器

DeBanK MCP 服務器是一個無狀態的模型上下文協議（MCP）服務器，可與 DeBanK 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 請求。

✨ 主要特性

• 無狀態架構：每個請求創建一個新的服務器實例和傳輸。
• 全面 DeFi 數據工具：可訪問鏈、協議、代幣、池和用戶數據。
• 分頁支持：所有返回列表的端點都支持分頁。
• 錯誤處理：具備強大的錯誤處理和報告機制。

📦 安裝指南

克隆倉庫

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

設置環境變量

export ACCESS_KEY=your_debank_api_key

💻 使用示例

基礎用法

以下是啟動服務器的基本命令：

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

高級用法

可以通過配置環境變量來調整服務器的運行參數，例如指定端口：

export PORT=8081
deno run --allow-net --allow-env main.ts

📚 詳細文檔

可用工具

配置

可以配置以下環境變量：

• ACCESS_KEY - 您的 DeBanK API 訪問密鑰
• PORT - （可選）服務器運行的端口（默認：8080）

🔧 技術細節

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              # 本文件

📄 許可證

本項目在 MIT 許可證下，有關詳細信息，請參閱 LICENSE 文件。

致謝

• 模型上下文協議
• DeBanK 團隊