mcpField
A
anima

anima

远程服务
useanima.sh通信协作25 周前更新
代码仓库访问官网

关于 anima

anima 是托管的 MCP 服务，为 AI Agent 提供邮件、电话、短信、语音和凭据管理能力。它通过单一网关及按领域划分的端点暴露 Anima 平台工具。

主要功能

  1. 01管理 Agent 身份与生命周期
  2. 02创建和管理邮件收件箱
  3. 03发送邮件并处理邮件线程
  4. 04配置电话号码及收发短信
  5. 05处理语音通话、转录和录音
  6. 06加密存储凭据并管理 OAuth 连接

适用场景

  1. 01为 AI Agent 配置独立邮件地址
  2. 02通过短信和语音处理通信任务
  3. 03在凭据库中存取认证信息

MCP 相关

该托管 MCP 服务通过 streamable HTTP 向客户端提供完整工具集，并支持 Authorization: Bearer 认证。/mcp 提供全部工具，另有按领域划分的端点。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://mcp.useanima.sh/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

@anima-labs/mcp-server

位于 https://mcp.useanima.sh 的托管 MCP 服务，是将 AI 助手连接到 Anima 的推荐方式。它通过支持流式传输的 HTTP 提供完整的工具集（目前有 66 个工具），并使用 Authorization: Bearer <ak_… or mk_…> 进行身份验证。

此软件包不会发布到 npm：它是已部署的网关。如需本地/stdio 服务，请使用 @anima-labs/mcp（已发布，包含 53 个核心工具）——使用同一平台和同一身份验证方式。两种客户端的设置说明都在 MCP 文档中，也可以运行 anima setup-mcp。

端点

一个网关，多个按范围划分的挂载点。/mcp 提供所有功能；按领域划分的挂载点则提供定制连接，工具数量更少：

  • /mcp — 所有工具（推荐）
  • /agent — Agent 生命周期（创建/获取/列出/更新/删除）
  • /email — Anima Agent 邮箱：收件箱创建/获取/列出/更新/删除、发送/回复/转发、邮件线程、草稿、附件、自定义域名（agents.useanima.sh 地址或你自己的域名——无需 Gmail/SMTP 中继）
  • /phone — 电话号码配置、短信线程、语音通话 + 转录文本/录音（由 Telnyx 提供支持）
  • /platform — 账户/用量概览和 Webhook 管理
  • /vault — 加密凭据保管库：增删改查、搜索、TOTP、服务器端使用、凭据请求、OAuth 连接、Connect Links
  • /extension — 浏览器扩展连接（无头模式 / Puppeteer）

在本地运行（开发）

bun run src/index.ts

环境变量：ANIMA_API_URL（默认指向本地开发 API http://127.0.0.1:3100；生产部署会将其设置为线上 API）、MCP_BASE_URL、PORT。

部署到生产环境（mcp.useanima.sh）

推荐通过 GitHub Actions 部署：通过 workflow_dispatch 运行 Deploy MCP Server（.github/workflows/deploy.yml）。

所需的仓库密钥（用于 Workload Identity Federation / OIDC）：

  • GCP_WORKLOAD_IDENTITY_PROVIDER（格式：projects/<number>/locations/global/workloadIdentityPools/<pool>/providers/<provider>）
  • GCP_SERVICE_ACCOUNT_EMAIL（anima-labs 中的部署服务账号）

工作流行为：

  • 构建并推送 us-central1-docker.pkg.dev/anima-labs/anima/mcp-server:<tag>
  • 将 Cloud Run 服务 mcp-server 部署到 us-central1
  • 输出 GET /health 的响应，供你确认 startedAt 已发生变化

仍可使用手动备用方案（使用相同的镜像/部署设置）：

./deploy.sh <tag>

历史

取代了五个独立软件包（mcp-agent、mcp-email、mcp-phone、mcp-platform、mcp-vault）以及共享库 mcp-core。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。