canton-mcp

Name: canton-mcp
Author: Noves-Inc

本地服务

github.com/Noves-Inc金融数据021 周前更新

代码仓库

关于 canton-mcp

canton-mcp 是只读 MCP 服务，通过 Noves Canton API 查询 Canton Network 数据，面向需要查询身份、余额、奖励、交易、CC 价格或网络目录的 AI Agent。

主要功能

01按名称或 ID 解析参与方
02搜索网络目录
03查询当前及历史余额
04查看奖励和分类交易
05获取 CC 价格及历史数据

适用场景

01查找目录中的超级验证者
02查看参与方当前或过往余额
03检查验证者的网络流量购买
04绘制指定时段的 CC 价格走势

MCP 相关

向 MCP 客户端提供 Canton Network 只读查询，包括身份、目录、余额、奖励、交易、活动和价格工具。需要 Noves API 密钥。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "noves-inc-canton": {
      "command": "npx",
      "args": [
        "-y",
        "@noves/canton-mcp"
      ],
      "env": {
        "NOVES_API_KEY": "<NOVES_API_KEY>"
      }
    }
  }
}

启动命令npx -y @noves/canton-mcp

需要配置的环境变量

NOVES_API_KEY密钥Your Noves API key. Create a free account at https://app.noves.fi/register/free

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@noves/canton-mcp0.2.3stdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
chain	string	否	要查询的链。默认为 "canton"（目前唯一支持的链）。
query	string	是	ANS 名称（例如 noves.unverified.cns）、显示名称片段（例如 Cumberland）或原始 party ID（name::hash）。

详细介绍

canton-mcp

向 AI 询问 Canton Network 相关问题。

一个用于 Noves Canton API 的 MCP 服务，可查询余额、奖励、分类交易、CC 价格、身份和网络目录，并可从 Claude Code、Claude Desktop、Cursor 或任何支持 MCP 的 Agent 中使用。

You: How has the CC price moved over the last 7 days? Chart it.
AI:  → get_price(startDate, endDate, interval: "daily")
     CC closed at $0.1462 today, up 4.2% on the week (low $0.1402, high $0.1521).
     [renders an interactive price chart]

快速开始

在 https://app.noves.fi/register/free 获取免费的 API 密钥。

Claude Desktop — 一键安装

从最新版本下载 canton-mcp.mcpb，双击（或拖入 Claude Desktop），然后在弹出的设置表单中粘贴 API 密钥。密钥会保存在操作系统的密钥链中。完成。

Claude Code

npx -y @noves/canton-mcp init   # one-time: prompts for your key, validates it, saves it
claude mcp add canton -- npx -y @noves/canton-mcp

也可以在一行命令中显式传入密钥：

claude mcp add canton --env NOVES_API_KEY=<your-key> -- npx -y @noves/canton-mcp

Cursor / 其他 MCP 客户端

运行 npx -y @noves/canton-mcp init 后，无需设置环境变量：

{
  "mcpServers": {
    "canton": {
      "command": "npx",
      "args": ["-y", "@noves/canton-mcp"]
    }
  }
}

（也可以跳过 init，添加 "env": { "NOVES_API_KEY": "<your-key>" }。）

密钥解析顺序： NOVES_API_KEY 环境变量 → --api-key 标志 → ~/.config/canton-mcp/config.json。密钥只会发送至 api.canton.noves.fi，绝不会记录到日志中。

工具

所有需要 party 参数的工具都接受 ANS 名称、显示名称或 原始 party ID（name::hash）——系统会自动解析；如果名称有歧义，则会返回候选列表供选择。

示例：

“Canton 上有哪些超级验证者？” → search_directory(orgType: "sv")
“Noves 当前的 CC 余额是多少？” → get_balance(party: "noves.unverified.cns")
“绘制 Noves 过去 30 天的余额图表。” → get_balance_history(party, startDate, endDate)
“显示该验证者最近的流量购买记录。” → get_transactions(party, txType: "buyTraffic")

工具	可回答的问题
`resolve_party`	“这是哪个 party？”——规范 party ID、组织类型、余额、ANS 名称
`search_directory`	“有哪些超级验证者？”——浏览/筛选网络目录
`get_balance`	“这个 party 的余额是多少？”——当前余额或任意时间点的余额（`date`）
`get_balance_history`	“绘制其上个月的余额图表”——每日收盘快照
`get_rewards`	“它获得了多少奖励？”——汇总指标、每日总额或单笔发放记录
`get_transactions`	“显示其最近的流量购买记录”——分类历史记录（transfer、buyTraffic、…）
`get_transfer_stats`	“它有多活跃？”——次数、交易量、唯一交易对手
`get_price`	“本月 CC 价格走势如何？”——现货价格、历史现货价格、小时/日 OHLC
`get_transaction`	按 ID 查询单笔更新的完整分类数据

请参阅 examples/PROMPTS.md 获取可尝试的问题。

说明与限制

只读。 此服务器只读取数据；无法更改网络或你的账户中的任何内容。
日期输入支持 ISO 日期（2026-06-01）、ISO 日期时间或 Unix 时间戳。
上游按 ≤30 天的时间窗口获取每日奖励；服务器每次调用最多合并 90 天的数据。
列表输出设有上限（默认 25 行），并提供 hasMore 提示，以保持 Agent 上下文精简。
get_transactions 默认返回 25 行，且接受最高为 100 的 limit；使用 includeCount 获取日期窗口内的总数，并使用 get_transaction 获取某次更新的完整信息。
链和交易类型（1 小时）、目录和身份查询（5 分钟）以及现货价格（60 秒）会在进程内缓存，使典型的 Agent 会话轻松保持在免费层级的限制内。