Animica

io.github.animicaorg由 GitHub 帳號 animicaorg 發布v0.2.2更新於 Oct 24, 2026

Read-only Animica chain data, free AI inference, verifiable quantum randomness, and mining stats.

已驗證Streamable HTTP可網頁執行金融資料與分析AI 與機器學習

概覽

AI 產生的概覽

Animica 讓助理以唯讀方式查詢 Animica 區塊鏈資料、使用免費的 OpenAI 相容 AI 推論、取得量子亂數並查看礦池統計。

可以做什麼
  • 向 Animica 的 AI 模型提問、列出可用模型並查詢 AI 任務狀態
  • 讀取鏈頭、區塊以及帳戶餘額與 nonce（唯讀，不簽章）
  • 取得最新量子亂數信標輪次，並計算可驗證抽籤（抽獎、洗牌、區間、骰子、位元組）
  • 離線驗證量子抽籤結果與 qDNA 基因封印，純本機運算
  • 查看礦池狀態與全網算力
  • 估算 Animica Studio 執行成本並列出已部署的 Studio 函式
適用情境
適合需要助理查看 Animica 鏈上資料、呼叫免費 OpenAI 相容模型、產生或驗證可證明公平的亂數結果，或了解挖礦與 Studio 資訊，同時不想接觸私鑰與資金的場合。
執行需求
可透過 uvx animica-mcp 或 pip install animica-mcp 以本機程序執行（需 Python），也可連線遠端 streamable-HTTP 端點。預設使用公開的 Animica 基礎設施，無需任何設定；選用環境變數可設定推論位址、RPC 位址、礦池位址、信標位址、預設模型、逾時與傳輸方式。ANIMICA_API_KEY 為選用項目，用於提高 AI 速率限制。
安裝前請注意
文件稱此伺服器為唯讀且不接觸金鑰：不簽章、不花費、不變更錢包狀態，鏈上呼叫僅限唯讀方法白名單。請求會送往第三方 Animica 基礎設施（推論、RPC、礦池、信標），因此提示內容與查詢會離開本機。ANIMICA_API_KEY 屬機密，應僅透過環境變數提供。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Animica，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.animicaorg%2Fanimica/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "animica": {
      "type": "http",
      "url": "https://mcp.animica.org/mcp"
    }
  }
}

README

Animica MCP Server

Registry & packaging mirror. The server source lives in the monorepo: https://github.com/animicaorg/all/tree/main/python/animica/mcp — it ships inside the animica PyPI wheel (animica.mcp.server, [mcp] extra). This repo holds the registry/packaging metadata (server.json, Smithery/Docker files) and contains zero server code, so it can never drift from the shipped implementation.

MCP (Model Context Protocol) server for the Animica AI + blockchain network. One command gives any MCP client (Claude Code, Claude Desktop, Cursor, VS Code, …) 15 read/compute tools: OpenAI-compatible AI inference, a verifiable quantum randomness beacon, read-only chain and account lookups, mining-pool stats, and Studio compute cost estimates.

The installable package is animica-mcp — a thin console wrapper around animica[mcp]; installing it pulls in the server and exposes the animica-mcp command.

Install

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

Tools (15)

ToolWhat it does
animica_infoOrientation: what Animica is, the AI API, quantum beacon, endpoints, docs. Start here.
animica_ai_askAsk Animica's ENA AI a question (OpenAI-compatible chat inference).
animica_ai_modelsList the AI models available on Animica's OpenAI-compatible API.
animica_ai_job_statusRead the status of an ENA AI request/job by id (read-only).
animica_quantum_beacon_latestLatest round of the verifiable quantum randomness beacon.
animica_quantum_drawCompute a verifiable quantum-random draw off a beacon round (lottery, choice, weighted, shuffle, range, coin, dice, bytes).
animica_quantum_verifyRe-verify a quantum-random draw client-side — pure offline compute.
animica_qdna_verify_geneVerify a qDNA training-genome gene seal (tamper-evidence) — pure offline compute.
animica_chain_headChain head: current height/hash and chain id. Read-only.
animica_chain_blockRead a block by height or hash (head block with neither). Read-only.
animica_chain_accountBalance + nonce for an anim1… address. Read-only — no keys, no signing.
animica_pool_statsLive mining-pool stats: pool status plus active miner count.
animica_network_hashrateCurrent network hashrate from the chain.
animica_studio_estimateEstimate the ANM cost of an Animica Studio run before paying — local quote, charges nothing.
animica_studio_functionsList functions deployed to Animica Studio. Read-only.

Client setup

Claude Code

bash
claude mcp add animica -- uvx animica-mcp

Claude Desktop

Add to claude_desktop_config.json:

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

Cursor

Add to ~/.cursor/mcp.json (or project .cursor/mcp.json):

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

VS Code

Add to .vscode/mcp.json:

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

If you installed with pip install animica-mcp, replace "command": "uvx", "args": ["animica-mcp"] with "command": "animica-mcp" in any of the configs above.

Configuration (environment variables)

All endpoints default to public Animica infrastructure — the server works with zero configuration.

VariableDefaultPurpose
ANIMICA_BASE_URLhttps://pool.animica.org/v1OpenAI-compatible inference API base (chat + models). https://animica.dev/v1 is the free keyless endpoint if you prefer it.
ANIMICA_RPC_URLhttps://rpc.animica.org/rpcNode JSON-RPC endpoint (read-only calls).
ANIMICA_POOL_URLhttps://pool.animica.orgMining-pool stats API.
ANIMICA_BEACON_URLhttps://pool.animica.orgQuantum randomness beacon (/beacon/*).
ANIMICA_API_KEY(empty)Optional Bearer key for the inference API; not required.
ANIMICA_MODELanm-fast-8bDefault model for animica_ai_ask.
ANIMICA_MCP_TIMEOUT_S60HTTP timeout (seconds) for backend calls.
MCP_TRANSPORTstdioTransport: stdio (default), streamable-http, or sse.

Transports

  • stdio (default) — what Claude Code / Claude Desktop / Cursor / VS Code use; just run animica-mcp.
  • streamable-http — MCP_TRANSPORT=streamable-http animica-mcp serves HTTP on 127.0.0.1:8765. For host/port flags use the full CLI from the animica package: animica mcp serve --transport http --host 0.0.0.0 --port 8765 (serves MCP at /mcp).
  • sse — MCP_TRANSPORT=sse animica-mcp (legacy SSE clients).

The Dockerfile + smithery.yaml in this repo package the streamable-HTTP mode for Smithery and other container hosts (listens on $PORT, serves MCP at /mcp).

Security posture

  • Read + compute only. Chain access goes through a hard-coded allow-list of read-only JSON-RPC methods (RPC_READ_ALLOWLIST in the source); mutating methods (send, sign, deploy, claim) are not on the list and cannot be reached, even by a bug.
  • No keys. The server never handles private keys, never signs, never spends, and never mutates wallet state.
  • Quantum draw/verify and qDNA gene verification are pure local compute and work fully offline.

Links

License

Apache-2.0

來源：README.md，提交 ad4414b

工具

0
SourceWeft 尚未讀取此伺服器的工具。

版本歷史

1
  1. v0.2.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式必需10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分