mcpField
M
mcp-for-api

mcp-for-api

ローカル
github.com/appwriteクラウド・インフラ72今日更新

mcp-for-api について

mcp-for-api は Appwrite の MCP サーバーで、データベース、ユーザー、関数、チーム、ストレージなどの API をツールとして MCP クライアントに公開します。Appwrite を利用する開発者を対象とし、ホスト型サーバーにはブラウザーの OAuth 認証で接続します。

主な機能

  1. 01ブラウザーの OAuth 認証によるホスト型サーバー
  2. 02データベース、ユーザー、関数、チーム、ストレージのツール
  3. 03セルフホスト型 Appwrite 向けのローカル stdio 実行
  4. 04組み込みのドキュメント検索ツール appwrite_search_docs

活用シーン

  1. 01AI クライアントからの Appwrite データベースとユーザーの管理
  2. 02コーディングセッション中の Appwrite 関数とストレージの呼び出し

MCP 対応

Appwrite API の操作を MCP クライアントから呼び出せるツールとして公開する MCP サーバーです。Claude Code、Cursor、VS Code、Codex など複数のクライアントの設定方法が記載されています。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"appwrite-mcp-for-api": {
"command": "uvx",
"args": [
"mcp-server-appwrite"
]
}
}
}
起動コマンドuvx mcp-server-appwrite

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypimcp-server-appwrite0.2.8

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Appwrite MCP サーバー

MCP Registry Version

Appwrite 用の Model Context Protocol サーバーです。 Appwrite の API(データベース、ユーザー、関数、チーム、ストレージなど)を、 MCP クライアントから呼び出せるツールとして公開します。

ホスト型サーバー https://mcp.appwrite.io/ に接続し、 ブラウザーから認証します。初回の接続時に、クライアントで Appwrite の 同意画面が開きます。スコープを承認すると接続できます。キーを コピーする必要はありません。一般的な https://mcp.appwrite.io/mcp の URL も サポートされており、同じサーバーに接続します。

Appwrite MCP サーバーが OAuth とスコープを処理する方法

クライアントを接続する

以下からクライアントを選択してください。どの方法でも、ホスト型 Appwrite Cloud サーバーが追加されます。

Claude Code
claude mcp add --transport http appwrite https://mcp.appwrite.io/

次に、Claude Code のセッション内で /mcp を実行し、appwrite を選択して、 ブラウザーに表示されるプロンプトに従って認証します。

Claude Desktop

Settings → Connectors → Add custom connector に移動し、 https://mcp.appwrite.io/ を貼り付けます。Pro および Max プランで利用できます。 Team および Enterprise プランでは、組織の Owner のみがカスタムコネクターを追加できます。

このオプションが表示されない場合(無料プラン、または Team/Enterprise のメンバーの場合)は、 代わりに stdio を介してリモートサーバーをブリッジしてください(Node.js が必要です)。Settings → Developer → Local MCP servers に移動し、 Edit Config をクリックして、次を追加します。

{
  "mcpServers": {
    "appwrite": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.appwrite.io/"]
    }
  }
}

Claude Desktop を再起動すると、サーバーが Local MCP servers に表示され、 認証用のブラウザーウィンドウが開きます。

Claude Desktop の Local MCP servers で実行中の Appwrite サーバー

Cursor

~/.cursor/mcp.json(グローバル)または .cursor/mcp.json(プロジェクト)を編集します。

{
  "mcpServers": {
    "appwrite": {
      "url": "https://mcp.appwrite.io/"
    }
  }
}

Cursor からブラウザー経由でログインするよう求められます。その後、サーバーは Settings → MCP に表示され、ツールが有効になります。

Cursor の MCP 設定で接続された Appwrite サーバー

VS Code(GitHub Copilot)

.vscode/mcp.json(ワークスペース)を編集するか、コマンド パレット → MCP: Open User Configuration からユーザー設定を編集します。

{
  "servers": {
    "appwrite": {
      "type": "http",
      "url": "https://mcp.appwrite.io/"
    }
  }
}
Codex

~/.codex/config.toml を編集します。

[mcp_servers.appwrite]
url = "https://mcp.appwrite.io/"

次に、ターミナルから認証します。

codex mcp login appwrite

Codex GUI では、MCP 設定からサーバーを追加することもできます。 URL に https://mcp.appwrite.io/ を設定し、トークンとヘッダーの フィールドは空のままにしてください(認証はブラウザー経由で行われます)。

Codex GUI の Appwrite MCP サーバー設定

OpenCode

opencode.json(プロジェクト)または ~/.config/opencode/opencode.json(グローバル)を編集します。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "appwrite": {
      "type": "remote",
      "url": "https://mcp.appwrite.io/",
      "enabled": true
    }
  }
}
Windsurf

~/.codeium/windsurf/mcp_config.json を編集します。

{
  "mcpServers": {
    "appwrite": {
      "serverUrl": "https://mcp.appwrite.io/"
    }
  }
}
Gemini CLI
gemini mcp add --transport http appwrite https://mcp.appwrite.io/

または ~/.gemini/settings.json を編集します(キーは url ではなく httpUrl です)。

{
  "mcpServers": {
    "appwrite": {
      "httpUrl": "https://mcp.appwrite.io/"
    }
  }
}

Gemini CLI は、初回の接続時にブラウザーでの OAuth フローを自動的に開始します。 再認証するには、セッション内で /mcp auth appwrite を実行します。

Antigravity(CLI & 2.0)

~/.gemini/config/mcp_config.json(グローバル)または .agents/mcp_config.json(プロジェクトのワークスペース)を編集します。

{
  "mcpServers": {
    "appwrite": {
      "serverUrl": "https://mcp.appwrite.io/"
    }
  }
}

⚠️ 注意: Antigravity では、リモートトランスポートに serverUrl キーが必須です。url や httpUrl などの旧形式のフィールドを使用すると、ツールの登録が失敗してもエラーは表示されません。 初回接続時、Antigravity はブラウザーでの OAuth フローを自動的に開始します。JSON ファイルを手動で編集した場合は、Settings → Customizations → Installed MCP Servers に移動し、Refresh をクリックしてツール定義を再読み込みしてください。

GitHub Copilot CLI
copilot mcp add --transport http appwrite https://mcp.appwrite.io/

セッション内で /mcp add を実行するか、~/.copilot/mcp-config.json を編集することもできます。

{
  "mcpServers": {
    "appwrite": {
      "type": "http",
      "url": "https://mcp.appwrite.io/"
    }
  }
}

初回接続時に、認証用のブラウザーウィンドウが開きます。ステータスは /mcp で確認できます。

Zed

Settings → AI → MCP Servers → Add Server → Add Remote Server に移動するか、 settings.json(zed: open settings)に追加します。

{
  "context_servers": {
    "appwrite": {
      "url": "https://mcp.appwrite.io/"
    }
  }
}

初回接続時に、Zed からブラウザーでの認証を求められます。

Warp

Settings → Agents → MCP servers → + Add に移動し、URL ベースの サーバータイプを選択して、https://mcp.appwrite.io/ を入力します。

初回接続時に、Warp で認証用のブラウザーウィンドウが開きます。

JetBrains AI Assistant / Junie

JetBrains IDE はリモート MCP サーバーの OAuth にまだ対応していないため、stdio 経由でブリッジしてください (Node.js が必要です)。Settings → Tools → AI Assistant → Model Context Protocol (MCP) → Add に移動し、JSON ビューに切り替えて、次を貼り付けます。

{
  "mcpServers": {
    "appwrite": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.appwrite.io/"]
    }
  }
}

初回接続時に、認証用のブラウザーウィンドウが開きます。

Cline

Cline はリモート MCP サーバーの OAuth にまだ対応していないため、stdio 経由でブリッジしてください (Node.js が必要です)。Cline パネルで、MCP Servers アイコン → Configure タブ → Configure MCP Servers を開き、次を追加します。

{
  "mcpServers": {
    "appwrite": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.appwrite.io/"]
    }
  }
}

初回接続時に、認証用のブラウザーウィンドウが開きます。

セルフホスト Appwrite

独自の Appwrite インスタンスを実行していますか?MCP サーバーをローカルで stdio 経由で実行し、 プロジェクト API キーで認証します。クライアントごとのセットアップについては、docs/self-hosted.md を参照してください。

ドキュメント

  • ツールの概要 — モデルに公開されるツールと Appwrite の内部カタログ。
  • Cloud の認証の仕組み — OAuth 2.1 フロー。
  • ドキュメント検索 — プロセス内の appwrite_search_docs ツールと、そのインデックスの再構築方法。
  • イベント — MCP Events:Appwrite プロジェクトの変更に対する Webhook サブスクリプション (開発中で、まだ利用できません)。
  • セルフホスト Appwrite — プロジェクト API キーを使ってサーバーをローカルで実行します。
  • ローカル開発 — サーバーのローカルでの実行、テスト、デバッグ。
  • AGENTS.md — 貢献者向けの完全なガイドと PR 前チェックリスト。

ライセンス

この MCP サーバーは MIT License の下でライセンスされています。詳細は LICENSE ファイルを 参照してください。

コメント

MCP は初めてですか?

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

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