Appwrite

🚀 Appwrite MCP サーバ

Appwrite は、Appwrite API とやり取りするための Model Context Protocol (MCP) サーバです。このサーバを使用すると、モデルコンテキストプロトコル（MCP）を介して直接 Appwrite プラットフォームと統合できます。

🚀 クイックスタート

このセクションでは、Appwrite MCP サーバの基本的な使い方を説明します。まずは、サーバを動かすための設定とインストールを行いましょう。

✨ 主な機能

• Appwrite API との MCP を介した直接的な統合が可能です。
• 複数のエディタ（Claude Desktop、Cursor、Windsurf Editor）との統合がサポートされています。

📦 インストール

.env ファイルの作成

プロジェクトのルートディレクトリに .env ファイルを作成し、以下の内容を追加します。

APPWRITE_API_KEY=あなたの API キー
APPWRITE_PROJECT_ID=あなたのプロジェクト ID
APPWRITE_ENDPOINT=https://api.appwrite.io （オプション、デフォルトはこの値）

uv を使用したインストール

• Linux または MacOS

curl -LsSf https://astral.sh/uv/install.sh | sh

• Windows (PowerShell)

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

pip を使用したインストール

pip install mcp-server-appwrite

💻 使用例

各エディタへの統合

Claude Desktop

1. Claude Desktop の設定を開きます。
2. Settings > MCP で、Add new MCP server をクリックします。
3. タイプを Command に選択し、Command フィールドに以下の内容を追加します。

• MacOS

env APPWRITE_API_KEY=あなたの API キー env APPWRITE_PROJECT_ID=あなたのプロジェクト ID uvx mcp-server-appwrite

• Windows

cmd /c SET APPWRITE_PROJECT_ID=あなたのプロジェクト ID && SET APPWRITE_API_KEY=あなたの API キー && uvx mcp-server-appwrite

Cursor

1. Cursor の設定を開きます。
2. Settings > Model Context Protocol (MCP) で、View raw config をクリックします。
3. mcp_config.json ファイルを更新します。

{
  "mcpServers": {
    "appwrite": {
      "command": "uvx",
      "args": [
        "mcp-server-appwrite"
      ],
      "env": {
        "APPWRITE_PROJECT_ID": "あなたのプロジェクト ID",
        "APPWRITE_API_KEY": "あなたの API キー",
        "APPWRITE_ENDPOINT": "https://api.appwrite.io" // オプション、デフォルトはこの値
      }
    }
  }
}

Windsurf Editor

1. Windsurf の設定を開きます。
2. Settings > Cascade > Model Context Protocol (MCP) Servers で、View raw config をクリックします。
3. mcp_config.json ファイルを更新します。

{
  "mcpServers": {
    "appwrite": {
      "command": "uvx",
      "args": [
        "mcp-server-appwrite"
      ],
      "env": {
        "APPWRITE_PROJECT_ID": "あなたのプロジェクト ID",
        "APPWRITE_API_KEY": "あなたの API キー",
        "APPWRITE_ENDPOINT": "https://api.appwrite.io" // オプション、デフォルトはこの値
      }
    }
  }
}

ローカル開発

リポジトリのクローン

git clone https://github.com/appwrite/mcp.git

uv のインストール

• Linux または MacOS

curl -LsSf https://astral.sh/uv/install.sh | sh

• Windows (PowerShell)

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

仮想環境の設定

1. 仮想環境を作成してアクティブ化します。

• Linux または MacOS

uv venv
source .venv/bin/activate

• Windows

.venv\Scripts\activate

2. サーバを起動します。

uv run -v --directory ./ mcp-server-appwrite

デバッグ

MCP チェックツールを使用してデバッグします。

npx @modelcontextprotocol/inspector \
  uv \
  run \
  --directory . \
  mcp-server-appwrite

ブラウザで http://localhost:8090 にアクセスします。

📄 ライセンス

このソフトウェアは MIT ライセンスの下で提供されています。自由に使用、修正、配布することができます。