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 分