mcpField
A
anima

anima

リモート
useanima.shコミュニケーション25 週間前に更新
リポジトリ公式サイト

anima について

animaは、AIエージェントにメール、電話、SMS、音声、認証情報管理を提供するホスト型MCPサーバーです。単一のゲートウェイと分野別エンドポイントからAnimaの機能を利用できます。

主な機能

  1. 01エージェントのIDとライフサイクル管理
  2. 02メール受信箱の作成と管理
  3. 03メール送信とスレッド処理
  4. 04電話番号の取得とSMS管理
  5. 05音声通話、文字起こし、録音の処理
  6. 06認証情報の暗号化保存とOAuth接続管理

活用シーン

  1. 01AIエージェント専用のメールアドレスを設定
  2. 02SMSや音声による連絡タスクを処理
  3. 03認証情報を保管して取得

MCP 対応

ホスト型MCPサーバーは、Bearer認証を用いたstreamable HTTPでクライアントにツールを提供します。/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 に接続するための推奨方法です。Authorization: Bearer <ak_… or mk_…> を使い、ストリーム可能な HTTP 経由でツール一式（現在は 66 個）を公開します。

このパッケージは、意図的に npm では公開していません。デプロイ済みのゲートウェイです。ローカル／stdio サーバーを使用する場合は、@anima-labs/mcp（公開済み、コアツール 53 個）をご利用ください。同じプラットフォームで、認証方法も同じです。どちらのクライアント設定も MCP docs に記載されています。または、anima setup-mcp を実行してください。

エンドポイント

1 つのゲートウェイに、用途別のマウントポイントを用意しています。/mcp はすべての機能を提供します。ドメイン別のマウントポイントは、ツール数を絞った用途に合わせた接続を提供します。

  • /mcp — すべてのツール（推奨）
  • /agent — エージェントのライフサイクル（作成／取得／一覧表示／更新／削除）
  • /email — Anima エージェントのメールボックス：受信トレイの作成／取得／一覧表示／更新／削除、送信／返信／転送、スレッド、下書き、添付ファイル、カスタムドメイン（agents.useanima.sh のアドレスまたは独自ドメイン。Gmail／SMTP リレーは不要）
  • /phone — 電話番号のプロビジョニング、SMS スレッド、音声通話と文字起こし／録音（Telnyx を使用）
  • /platform — アカウント／使用状況の概要と Webhook 管理
  • /vault — 暗号化された認証情報の保管庫：CRUD、検索、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> をビルドしてプッシュします
  • us-central1 の Cloud Run サービス mcp-server をデプロイします
  • GET /health の応答を出力します。startedAt が変わったことを確認できます

手動での代替手順も引き続き利用できます（同じイメージ／デプロイ設定です）。

./deploy.sh <tag>

履歴

5 つの個別パッケージ（mcp-agent、mcp-email、mcp-phone、mcp-platform、mcp-vault）と共有ライブラリ mcp-core を置き換えます。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。