canton-mcp

canton-mcp

Canton Network について AI に質問できます。

Noves Canton API 用の MCP サーバーです。残高、報酬、分類済みトランザクション、 CC 価格、ID、ネットワークディレクトリを、Claude Code、Claude Desktop、Cursor、または MCP 対応のあらゆるエージェントから照会できます。

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]

クイックスタート

無料の API キーを https://app.noves.fi/register/free で取得してください。

Claude Desktop — ワンクリック

canton-mcp.mcpb を最新リリース からダウンロードし、ダブルクリックする（または Claude Desktop にドラッグする）と、表示される 設定フォームに API キーを貼り付けられます。キーは OS のキーチェーンに保存されます。これで完了です。

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

または、キーを明示的に渡して 1 行で実行できます。

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 名、表示名、または 生のパーティー ID（name::hash）に対応しています。自動的に解決され、名前が 曖昧な場合は候補リストが返されます。

例：

• 「Canton のスーパーバリデーターは誰ですか？」→ search_directory(orgType: "sv")
• 「Noves の現在の CC 残高はいくらですか？」→ get_balance(party: "noves.unverified.cns")
• 「過去 30 日間の Noves の残高をグラフにしてください。」→ get_balance_history(party, startDate, endDate)
• 「このバリデーターの最近のトラフィック購入を表示してください。」→ get_transactions(party, txType: "buyTraffic")

ツール	回答する内容
resolve_party	「このパーティーは誰ですか？」— 正式なパーティー ID、組織タイプ、残高、ANS 名
search_directory	「スーパーバリデーターは誰ですか？」— ネットワークディレクトリの閲覧／絞り込み
get_balance	「このパーティーの残高はいくらですか？」— 現在、または指定時点（date）の残高
get_balance_history	「先月の残高をグラフにしてください」— 日ごとの終値スナップショット
get_rewards	「どれだけ獲得しましたか？」— 概要指標、日ごとの合計、または個別の支払い
get_transactions	「最近のトラフィック購入を表示してください」— 分類済み履歴（transfer、buyTraffic、…）
get_transfer_stats	「どのくらい活発ですか？」— 件数、取引量、ユニークな取引相手
get_price	「今月の CC 価格の推移は？」— 現物価格、過去の現物価格、時間別／日別 OHLC
get_transaction	ID で指定した更新 1 件の分類済みペイロード全体

試してみる質問については、examples/PROMPTS.md をご覧ください。

注意事項と制限

• 読み取り専用です。 サーバーはデータを読み取るだけで、ネットワーク上やアカウント内の情報を変更することはできません。
• 日付の入力には、ISO 形式の日付（2026-06-01）、ISO 形式の日時、または Unix タイムスタンプを使用できます。
• デイリー報酬は、上流で30日以内の期間ごとに取得されます。サーバーは1回の呼び出しで最大90日分をまとめます。
• エージェントのコンテキストを軽く保つため、一覧の出力には上限があります（デフォルトは25行）。上限を超える場合は hasMore で示されます。
• get_transactions はデフォルトで25行を返し、limit は最大100まで指定できます。日付範囲内の合計件数を取得するには includeCount を使用し、更新内容全体を1件取得するには get_transaction を使用してください。
• チェーン／トランザクション種別（1時間）、ディレクトリと ID の検索（5分）、スポット価格（60秒）はプロセス内にキャッシュされるため、通常のエージェントセッションは無料枠内に十分収まります。

ライセンス

MIT © Noves Inc.