MPC 计数器 API 服务器

一个用于与计数器 API 交互的模型上下文协议（MCP）服务器。此服务器允许 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