English Français العربية

io.github.anima-labs-ai/anima

السجل الرسمي الإنتاجية

Give your AI agent an identity it owns: email inbox, US phone number, SMS, voice, and a vault.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http anima 'https://mcp.useanima.sh/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "anima": {
            "type": "http",
            "url": "https://mcp.useanima.sh/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. @anima-labs/mcp-server
  2. Endpoints
  3. Run locally (development)
  4. Deploy production (mcp.useanima.sh)
  5. History

@anima-labs/mcp-server

The hosted MCP server behind https://mcp.useanima.sh — the recommended way to connect AI assistants to Anima. It exposes the full tool surface (66 tools today) over streamable HTTP with Authorization: Bearer <ak_… or mk_…>.

This package is deliberately not published to npm: it is the deployed gateway. For a local/stdio server use @anima-labs/mcp (published, 53 core tools) — same platform, same auth. Client setup for both lives in the MCP docs, or run anima setup-mcp.

Endpoints

One gateway, scoped mounts. /mcp carries everything; the per-domain mounts serve tailored connections with a smaller tool count:

  • /mcp — all tools (recommended)
  • /agent — agent lifecycle (create/get/list/update/delete)
  • /email — Anima agent mailboxes: inbox create/get/list/update/delete, send/reply/forward, threads, drafts, attachments, custom domains (agents.useanima.sh addresses or your own domain — no Gmail/SMTP relay involved)
  • /phone — phone number provisioning, SMS threads, voice calls + transcripts/recordings (Telnyx-backed)
  • /platform — account/usage overviews and webhook management
  • /vault — encrypted credential vault: CRUD, search, TOTP, server-side use, credential requests, OAuth connections, Connect Links
  • /extension — browser extension connect (headless / Puppeteer)

Run locally (development)

bun run src/index.ts

Environment: ANIMA_API_URL (defaults to a local dev API at http://127.0.0.1:3100; the production deployment sets it to the live API), MCP_BASE_URL, PORT.

Deploy production (mcp.useanima.sh)

Preferred path is GitHub Actions: run Deploy MCP Server (.github/workflows/deploy.yml) via workflow_dispatch.

Required repository secrets (for Workload Identity Federation / OIDC):

  • GCP_WORKLOAD_IDENTITY_PROVIDER (format: projects/<number>/locations/global/workloadIdentityPools/<pool>/providers/<provider>)
  • GCP_SERVICE_ACCOUNT_EMAIL (deployer service account in anima-labs)

Workflow behavior:

  • Builds and pushes us-central1-docker.pkg.dev/anima-labs/anima/mcp-server:<tag>
  • Deploys Cloud Run service mcp-server in us-central1
  • Prints GET /health response so you can confirm startedAt changed

Manual fallback (same image/deploy settings) remains:

./deploy.sh <tag>

History

Replaces five separate packages (mcp-agent, mcp-email, mcp-phone, mcp-platform, mcp-vault) and the mcp-core shared library.

الأسئلة الشائعة

ما هو io.github.anima-labs-ai/anima؟

Give your AI agent an identity it owns: email inbox, US phone number, SMS, voice, and a vault.

كيف أثبّت io.github.anima-labs-ai/anima؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http anima 'https://mcp.useanima.sh/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.anima-labs-ai/anima إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.anima-labs-ai/anima مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.anima-labs-ai/anima؟

ينشره anima-labs-ai. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.