MPC Tally API Server

MPC Tally API Server

site icon
2025.02.07 4
TypeScriptDAO 信息获取治理数据分析Tally API 集成开发效率交流协作
MPC Tally API Server 是一个基于 Model Context Protocol (MCP) 的服务,用于与 Tally API 进行交互。该服务允许 AI 代理获取关于 DAOs(去中心化自治组织)的信息,包括治理数据、提案和元数据。 核心功能包括: - 按受欢迎程度或探索状态列出 DAOs - 获取包括社交链接和治理信息在内的完整 DAO 元数据 - 支持处理大型结果集的分页 - 使用 TypeScript 和 GraphQL 构建 - 使用 Bun 的测试运行器进行完整测试覆盖 适用场景: - 需要获取 DAO 信息的 AI 代理 - 需要分析 DAO 治理数据的开发者 - 需要集成 Tally API 的应用
View on GitHub

Overview

基本能力

核心功能

  • 按受欢迎程度或探索状态列出 DAOs
  • 获取包括社交链接和治理信息在内的完整 DAO 元数据
  • 支持处理大型结果集的分页
  • 使用 TypeScript 和 GraphQL 构建
  • 使用 Bun 的测试运行器进行完整测试覆盖

使用场景

  • 需要获取 DAO 信息的 AI 代理
  • 需要分析 DAO 治理数据的开发者
  • 需要集成 Tally API 的应用

工具列表

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

API 函数

list_daos

列出按指定条件排序的 DAOs。

参数: - limit (可选): 返回的 DAOs 最大数量 (默认: 20, 最大: 50) - afterCursor (可选): 用于分页的游标 - sortBy (可选): 如何排序 DAOs (默认: popular) - 选项: "id", "name", "explore", "popular"

使用教程

使用依赖

  1. 安装 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
  1. Tally 获取 API 密钥

⚠️ 安全注意事项: - 不要提交你的 .env 文件 - 不要在日志或错误消息中暴露你的 API 密钥 - 如果 API 密钥暴露,请立即更换 - 使用环境变量进行配置

调试方式

# 启动服务器
bun run start

# 开发模式,支持自动重载
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"
    }
  }
}

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。