Animica

Animica MCP 服务

注册表与打包镜像。 服务源代码位于 monorepo 中： https://github.com/animicaorg/all/tree/main/python/animica/mcp — 随 animica PyPI wheel 一同发布（animica.mcp.server， [mcp] extra）。此仓库仅保存注册表/打包元数据（server.json、 Smithery/Docker 文件），不包含任何服务代码，因此永远不会与已发布的实现产生偏差。

适用于 Animica AI + 区块链网络的 MCP（Model Context Protocol）服务。只需一条命令，即可为任何 MCP 客户端（Claude Code、Claude Desktop、Cursor、VS Code，……）提供 15 种读取/计算工具：兼容 OpenAI 的 AI 推理、可验证的量子随机信标、只读链和账户查询、矿池统计信息，以及 Studio 计算成本估算。

可安装的软件包是 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	按 ID 读取 ENA AI 请求/任务的状态（只读）。
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… 地址的余额 + nonce。只读——无需密钥，也不签名。
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 基础地址（聊天 + 模型）。如果更喜欢免费的免密钥端点，可使用 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 会打包 streamable-HTTP 模式，供 Smithery 和其他容器主机使用（监听 $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