使用说明

项目简介

MPC Tally API Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为AI Agent提供访问 Tally API 以获取 DAO (去中心化自治组织) 治理数据的标准化接口。通过此服务器，AI Agent可以查询 DAO 的基本信息、提案详情、治理代表等数据，从而更好地理解和参与 DAO 的治理过程。

主要功能点

• DAO 信息查询: 支持按流行度或探索状态列出 DAO，并获取 DAO 的详细元数据，包括社交链接和治理信息。
• 提案数据获取: 可以检索 DAO 的提案列表，并获取特定提案的详细信息，包括提案状态、投票情况、时间线等。
• 代表信息查询: 支持列出 DAO 的治理代表，并获取代表的元数据和委托信息。
• 分页支持: 对于大型数据集，API 提供分页功能，方便 AI Agent 分批处理数据。
• 工具集成: 通过 MCP 协议提供的工具 (Tools) 机制，将上述功能以标准化的方式暴露给 LLM 客户端。

安装步骤

1. 克隆仓库:

   git clone https://github.com/crazyrabbitLTC/mpc-tally-api-server.git
   cd mpc-tally-api-server
   

2. 安装依赖:

   bun install
   

3. 构建项目:

   bun run build
   

服务器配置

1. 在项目根目录下创建 '.env' 文件，并填入 Tally API 密钥。请从 Tally 获取 API 密钥。

   TALLY_API_KEY=your_api_key_here
   

2. Claude Desktop 配置示例

   以下 JSON 配置示例展示了如何在 Claude Desktop 中配置 MPC Tally API Server。您需要根据实际情况修改 'command' 和 'args' 中的路径。

   {
     "tally": {
       "command": "node",
       "args": [
         "/path/to/mpc-tally-api-server/build/index.js"
       ],
       "env": {
         "TALLY_API_KEY": "your_api_key_here"
       }
     }
   }
   

   • 'server name': 'tally' (用户可自定义，与配置JSON中的 "tally" 字段对应)
   • 'command': 'node' (Node.js 运行时环境)
   • 'args': '["/path/to/mpc-tally-api-server/build/index.js"]' (服务器启动脚本的绝对路径，请替换为实际路径)
   • 'env': '{"TALLY_API_KEY": "your_api_key_here"}' (环境变量，用于传递 Tally API 密钥，请替换为您的实际 API 密钥，注意：请勿将真实的 API 密钥直接硬编码在 JSON 配置文件中，推荐使用环境变量的方式 )

基本使用方法

1. 启动服务器:

   bun run start
   

   或使用开发模式：

   bun run dev
   

2. 在 MCP 客户端中配置并连接到服务器。 配置信息参考上面的 Claude Desktop 配置示例。

3. 通过 MCP 客户端调用服务器提供的工具 (Tools)，例如：

   • 'list-daos': 列出 DAO 列表。
   • 'get-dao': 获取指定 DAO 的详细信息，需要 DAO 的 slug (例如 "uniswap") 作为参数。
   • 'list-proposals': 列出指定 DAO 的提案，需要 DAO 的 slug 作为参数。
   • 'get-proposal': 获取指定提案的详细信息，需要提案 ID 作为参数。
   • 'list-delegates': 列出指定 DAO 的代表，需要 DAO 的 organizationSlug 作为参数。
   • 更多工具请参考仓库 'README.md' 或 'src/tools.ts' 文件。

注意:

• 请确保已安装 Node.js 和 bun 包管理器。
• 请妥善保管您的 Tally API 密钥，避免泄露。
• 服务器默认使用 Stdio 传输协议与客户端通信。