MPC Tally API Server

MPC Tally API 服务

一个用于与 Tally API 交互的模型上下文协议（MCP）服务。此服务允许 AI Agent 获取 DAO 信息，包括其治理数据、提案和元数据。

功能

• 按受欢迎程度或探索状态对 DAO 排序并列出
• 获取全面的 DAO 元数据，包括社交链接和治理信息
• 支持分页，便于处理大型结果集
• 使用 TypeScript 和 GraphQL 构建
• 使用 Bun 的测试运行器实现完整的测试覆盖

安装

# Clone the repository
git clone https://github.com/yourusername/mpc-tally-api-server.git
cd mpc-tally-api-server

# Install dependencies
bun install

# Build the project
bun run build

配置

1. 在根目录中创建 .env 文件：

TALLY_API_KEY=your_api_key_here

2. 从 Tally 获取 API 密钥

⚠️ 安全提示：妥善保管 API 密钥：

• 切勿提交 .env 文件
• 不要在日志或错误消息中泄露 API 密钥
• 如果 API 密钥泄露，请将其轮换
• 使用环境变量进行配置

使用方法

运行服务

# Start the server
bun run start

# Development mode with auto-reload
bun run dev

Claude Desktop 配置

将以下内容添加到 Claude Desktop 配置中：

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

可用脚本

• bun run clean - 清理构建目录
• bun run build - 构建项目
• bun run start - 运行构建后的服务
• bun run dev - 在开发模式下运行并自动重新加载
• bun test - 运行测试
• bun test --watch - 以监视模式运行测试
• bun test --coverage - 运行测试并生成覆盖率报告

API 函数

该服务提供以下 MCP 函数：

list_daos

按指定条件对 DAO 排序并列出。

参数：

• limit（可选）：要返回的 DAO 最大数量（默认值：20，最大值：50）
• afterCursor（可选）：用于分页的游标
• sortBy（可选）：DAO 的排序方式（默认值：popular）
  • 选项："id"、"name"、"explore"、"popular"

许可证

MIT