Tally DAO Governance

🚀 MPC 计数器 API 服务器

MPC 计数器 API 服务器是一个基于模型上下文协议（MCP）的服务器，用于与计数器 API 进行交互。借助该服务器，AI 代理能够获取 DAO 的相关信息，涵盖治理数据、提案以及元数据等内容。

✨ 主要特性

• 支持按照受欢迎程度或探索状态对 DAO 进行列表展示。
• 可获取全面的 DAO 元数据，其中包含社交链接和治理信息。
• 具备分页处理功能，可应对大量结果集。
• 采用 TypeScript 和 GraphQL 构建。
• 拥有完整的测试覆盖，并使用 Bun 的测试运行器。

📦 安装指南

# 克隆仓库
git clone https://github.com/yourusername/mpc-tally-api-server.git
cd mpc-tally-api-server

# 安装依赖项
bun install

# 构建项目
bun run build

📚 详细文档

配置

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

TALLY_API_KEY=your_api_key_here

2. 从 计数器 获取你的 API 密钥。

⚠️ 重要提示

请务必保护好你的 API 密钥：

• 永远不要将 .env 文件提交到版本控制系统。
• 不要在日志或错误消息中暴露你的 API 密钥。
• 如果密钥被泄露，请立即更换。
• 使用环境变量进行配置。

使用方法

运行服务器

# 启动服务器
bun run start

# 开发模式，带自动重载
bun run dev

与 Claude 桌面配置

将以下内容添加到你的 Claude 桌面配置中：

{
  "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