Animica

Animica MCP サーバー

レジストリとパッケージングのミラーです。 サーバーのソースはモノレポにあります。 https://github.com/animicaorg/all/tree/main/python/animica/mcp — animica PyPI ホイール（animica.mcp.server、[mcp] エクストラ）に同梱されています。このリポジトリにはレジストリ／パッケージングのメタデータ（server.json、 Smithery／Docker ファイル）のみがあり、サーバーコードは一切含まれていないため、公開される実装と異なることはありません。

Animica の AI とブロックチェーンネットワーク向け MCP（Model Context Protocol）サーバーです。1 つのコマンドで、あらゆる MCP クライアント（Claude Code、Claude Desktop、Cursor、VS Code など）から、OpenAI 互換の AI 推論、検証可能な量子乱数ビーコン、読み取り専用のチェーンとアカウントの照会、マイニングプール統計、Studio の計算コスト見積もりを行う 15 個のツールを利用できます。

インストール可能なパッケージは animica-mcp です。これは animica[mcp] をラップする軽量なコンソールラッパーです。インストールするとサーバーが導入され、animica-mcp コマンドが利用可能になります。

インストール

pip install animica-mcp
# or run it without installing:
uvx animica-mcp

ツール（15 個）

ツール	説明
animica_info	Animica の概要、AI API、量子ビーコン、エンドポイント、ドキュメントを案内します。まずはこちらをご覧ください。
animica_ai_ask	Animica の ENA AI に質問します（OpenAI 互換のチャット推論）。
animica_ai_models	Animica の OpenAI 互換 API で利用可能な AI モデルを一覧表示します。
animica_ai_job_status	ENA AI のリクエスト／ジョブの状態を ID で確認します（読み取り専用）。
animica_quantum_beacon_latest	検証可能な量子乱数ビーコンの最新ラウンドを取得します。
animica_quantum_draw	ビーコンのラウンドを使って、検証可能な量子乱数抽選を計算します（宝くじ、選択、重み付け、シャッフル、範囲、コイン、サイコロ、バイト）。
animica_quantum_verify	クライアント側で量子乱数抽選を再検証します。完全にオフラインで計算します。
animica_qdna_verify_gene	qDNA トレーニングゲノムの遺伝子シールを検証します（改ざん検出）。完全にオフラインで計算します。
animica_chain_head	チェーンヘッドの現在の高さ／ハッシュとチェーン ID を取得します。読み取り専用です。
animica_chain_block	高さまたはハッシュでブロックを読み取ります（どちらも指定しない場合はヘッドブロック）。読み取り専用です。
animica_chain_account	anim1… アドレスの残高とナンスを取得します。読み取り専用です。鍵や署名は扱いません。
animica_pool_stats	マイニングプールの稼働状況とアクティブなマイナー数を含む、最新の統計情報を取得します。
animica_network_hashrate	チェーンから現在のネットワークハッシュレートを取得します。
animica_studio_estimate	支払い前に Animica Studio の実行にかかる ANM コストを見積もります。ローカルで見積もるため、請求は発生しません。
animica_studio_functions	Animica Studio にデプロイされた関数を一覧表示します。読み取り専用です。

クライアントのセットアップ

Claude Code

claude mcp add animica -- uvx animica-mcp

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "animica": {
      "command": "uvx",
      "args": ["animica-mcp"]
    }
  }
}

Cursor

~/.cursor/mcp.json（またはプロジェクトの .cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "animica": {
      "command": "uvx",
      "args": ["animica-mcp"]
    }
  }
}

VS Code

.vscode/mcp.json に追加します。

{
  "servers": {
    "animica": {
      "type": "stdio",
      "command": "uvx",
      "args": ["animica-mcp"]
    }
  }
}

pip install animica-mcp でインストールした場合は、上記のいずれかの設定で "command": "uvx", "args": ["animica-mcp"] を "command": "animica-mcp" に置き換えてください。

設定（環境変数）

すべてのエンドポイントは、デフォルトで Animica の公開インフラストラクチャを使用するため、設定なしでサーバーを利用できます。

変数	デフォルト	用途
ANIMICA_BASE_URL	https://pool.animica.org/v1	OpenAI 互換の推論 API のベース URL（チャット＋モデル）。無料でキー不要のエンドポイントを利用する場合は、https://animica.dev/v1 を指定してください。
ANIMICA_RPC_URL	https://rpc.animica.org/rpc	ノードの JSON-RPC エンドポイント（読み取り専用の呼び出し）。
ANIMICA_POOL_URL	https://pool.animica.org	マイニングプールの統計 API。
ANIMICA_BEACON_URL	https://pool.animica.org	量子乱数ビーコン（/beacon/*）。
ANIMICA_API_KEY	(空)	推論 API 用のオプションの Bearer キーです。必須ではありません。
ANIMICA_MODEL	anm-fast-8b	animica_ai_ask のデフォルトモデル。
ANIMICA_MCP_TIMEOUT_S	60	バックエンド呼び出しの HTTP タイムアウト（秒）。
MCP_TRANSPORT	stdio	トランスポート：stdio（デフォルト）、streamable-http、または sse。

トランスポート

• stdio（デフォルト）— Claude Code／Claude Desktop／Cursor／VS Code で使用される方式です。animica-mcp を実行するだけです。
• streamable-http — MCP_TRANSPORT=streamable-http animica-mcp を実行すると、127.0.0.1:8765 で HTTP を提供します。ホスト／ポートのフラグを指定するには、animica パッケージの完全な CLI を使用します：animica mcp serve --transport http --host 0.0.0.0 --port 8765（/mcp で MCP を提供します）。
• sse — MCP_TRANSPORT=sse animica-mcp（レガシー SSE クライアント向け）。

このリポジトリの Dockerfile と smithery.yaml は、Smithery やその他のコンテナホスト向けに streamable-HTTP モードをパッケージ化しています（$PORT でリッスンし、/mcp で MCP を提供します）。

セキュリティ方針

• 読み取りと計算のみ。 チェーンへのアクセスには、ハードコードされた読み取り専用 JSON-RPC メソッドの許可リスト（ソース内の RPC_READ_ALLOWLIST）を使用します。変更を伴うメソッド（送信、署名、デプロイ、請求）はリストに含まれていないため、バグがあっても実行できません。
• キーは扱いません。 サーバーが秘密鍵を扱ったり、署名したり、資産を使用したり、ウォレットの状態を変更したりすることはありません。
• 量子乱数の生成／検証と qDNA 遺伝子の検証は、ローカルで完結する処理であり、完全にオフラインで動作します。

リンク

• ホームページ：https://animica.dev（無料の OpenAI 互換 AI API：https://animica.dev/v1）
• 開発者向けドキュメント：https://animica.org/developers/
• エクスプローラー：https://explorer.animica.org
• マイニングプール：https://pool.animica.org
• モノレポ（サーバーのソース）：https://github.com/animicaorg/all
• PyPI ラッパー：https://pypi.org/project/animica-mcp/
• コアパッケージ：https://pypi.org/project/animica/
• お問い合わせ：[email protected]

ライセンス

Apache-2.0