appwrite — AIエージェント連携やセルフホストに対応したオープンソースBaaS
appwrite/appwrite
★ 58,249 ・ TypeScript ・ BSD-3-Clause
概要
Appwriteは、Webやモバイルアプリケーションの開発に必要なバックエンド機能を統合して提供するオープンソースのBaaS(Backend as a Service)プラットフォームです。認証、データベース、ファイルストレージ、サーバーレス関数、リアルタイム通知、フロントエンドホスティングなどの多岐にわたるプロダクトが単一の基盤にまとめられています。
近年では「AIエージェント対応(agent-first)」を掲げており、Model Context Protocol(MCP)サーバーを公式に提供している点が特徴です。これにより、開発者自身がSDKを組み込んで利用するだけでなく、CursorやClaude CodeなどのコーディングエージェントがAppwrite上のリソースを直接操作・管理するワークフローを構築できます。マネージドサービスであるAppwrite Cloudが提供されているほか、Dockerを用いた完全なセルフホスト環境もサポートされており、インフラを自前で運用したい開発者にも適しています。
主な特徴
Appwriteは、アプリケーション構築に必要な要素をモジュール単位で提供しながら、それらを統合的に管理できるよう設計されています。READMEに記載されている主なプロダクトと特徴は以下の通りです。
- 多様な認証手段を提供する「Appwrite Auth」: メール/パスワード、SMS、OAuth、匿名セッション、マジックURLなどを利用したユーザー認証に対応しています。
- 柔軟なデータ管理を可能にする「Appwrite Databases」: 独自のAppwriteデータベースに加え、マネージドのPostgreSQLやMySQLと連携したモデリングおよびクエリ実行に対応しています。
- メディア処理と権限管理を備えた「Appwrite Storage」: ファイルの暗号化や圧縮、画像の動的リサイズなどの変換機能、アクセス制御ポリシーを備えたオブジェクトストレージです。
- イベント駆動で動作する「Appwrite Functions」: 安全に分離されたランタイム環境で実行されるサーバーレス関数を提供し、イベントをトリガーにした処理を実装できます。
- フロントエンドをデプロイできる「Appwrite Sites」: Gitリポジトリと連携し、静的サイトやSSR(サーバーサイドレンダリング)、CSR(クライアントサイドレンダリング)のフロントエンドを即時プレビュー付きでホストできます。
- 一元化された通知基盤「Appwrite Messaging」: メール、SMS、プッシュ通知の配信を1つのサービスから一貫して管理・送信できます。
- 保護とトラフィック制御を担う「Appwrite Firewall」: トラフィックルール、不正利用防止コントロール、エッジセキュリティ機能によってプロジェクトを保護します。
- 即時通信を実現する「Appwrite Realtime」: プロジェクト内の各種イベントを購読し、リアルタイムに変更や通知をクライアント側で検知・反映できます。
- AI連携を実現する「Appwrite MCP」: クラウド版では追加インストール不要でMCPサーバーが提供され、各種AIエージェントからAppwriteのAPIやドキュメントにアクセスできます。
使い方
Appwriteの利用方法は大きく分けて、公式のマネージドサービス「Appwrite Cloud」を利用する方法と、自身のインフラ上で「セルフホスト」する方法の2通りがあります。
1. Appwrite Cloudの利用
最も簡単な導入手順として、公式サイト(cloud.appwrite.io)でアカウントを登録する方法が案内されています。無料枠(Free plan)が用意されており、規模に応じた有料プランへの移行も可能です。
2. セルフホスト(ローカル環境や自前サーバーでの起動)
Dockerがインストールされている環境であれば、1つのコマンドを実行するだけでセットアップウィザードを起動できます。セットアップウィザードはローカルホスト(127.0.0.1)のポート20080で待機し、ターミナル上に1回限りのシークレット(Installer Secret)が出力されます。
Unix系(Linux / macOS)の場合
docker run -it --rm \
--publish 127.0.0.1:20080:20080 \
--volume /var/run/docker.sock:/var/run/docker.sock \
--volume "$(pwd)"/appwrite:/usr/src/code/appwrite:rw \
--entrypoint="install" \
appwrite/appwrite:2.7.2
Windows(CMD)の場合
docker run -it --rm ^
--publish 127.0.0.1:20080:20080 ^
--volume //var/run/docker.sock:/var/run/docker.sock ^
--volume "%cd%"/appwrite:/usr/src/code/appwrite:rw ^
--entrypoint="install" ^
appwrite/appwrite:2.7.2
Windows(PowerShell)の場合
docker run -it --rm `
--publish 127.0.0.1:20080:20080 `
--volume /var/run/docker.sock:/var/run/docker.sock `
--volume ${pwd}/appwrite:/usr/src/code/appwrite:rw `
--entrypoint="install" `
appwrite/appwrite:2.7.2
コマンド実行後、ターミナルに表示されるワンタイムシークレット付きのURLをブラウザで開いてウィザードを進めます。セットアップ完了後は、ブラウザから http://localhost を開くことでAppwriteの管理コンソールにアクセスできます。
3. AIエージェントとの接続(MCP)
CursorやClaude Code、CodexなどのMCP対応クライアントからAppwrite Cloudを利用する場合、クライアントの設定に以下のMCPサーバー設定を追加します。OAuth認証が採用されているため、個別のAPIキーを手動発行・管理する必要がありません。
{
"mcpServers": {
"appwrite": {
"url": "https://mcp.appwrite.io/"
}
}
}
また、エージェントが適切なSDK呼び出しを行えるようにするためのスキルセットも提供されており、以下のコマンドで導入できます。
npx skills add appwrite/agent-skills
なお、セルフホスト環境のAppwriteと連携させる場合は、ローカルMCPサーバーの設定を利用する形式になります。
技術的なポイント
READMEから読み取れる技術的構成や設計には、次のような特徴があります。
- TypeScriptを中心としたエコシステム: リポジトリの主要言語としてTypeScriptが採用されており、周辺ツールやSDKを含めた型安全な開発体験を意識した構成となっています。
- Dockerコンテナによる堅牢な配布形態: セルフホスト環境はDockerコンテナをベースに配布されており、ホストの
docker.sockをマウントしてセットアップを行うインストーラーコンテナが提供されています。これにより、複雑なマルチコンテナ構成の初期設定を対話型またはWebウィザード形式で自動化しています。 - 多様なプラットフォームへのワンクリック展開: ローカルのDocker実行だけでなく、DigitalOcean、Gitpod、Akamai Compute、AWS Marketplace向けに事前構成されたマーケットプレイスアプリや、GCP、Azure、Coolify、Dokploy向けのガイドが整備されています。
- 外部データベースの統合サポート: 独自の組み込みデータベースだけでなく、PostgreSQLやMySQLといった既存の一般的なリレーショナルデータベースを選択肢として組み込める設計になっています。
- MCP(Model Context Protocol)のネイティブ統合: 単なるREST/GraphQL APIの提供にとどまらず、AIアシスタントやコーディングエージェントがコンテキストを解釈して直接API操作を行えるよう、プロトコルレベルでのサポートを組み込んでいます。
注意点
Appwriteを導入・運用する際には、以下の点に留意する必要があります。
- ライセンス体系: 本リポジトリは「BSD-3-Clause」ライセンスのもとで公開されています。商用・非商用問わず利用可能ですが、著作権表示や免責条項の保持が求められます。
- Docker APIバージョンの不一致: ホスト側のDocker Engineが古い場合、インストーラー内のDocker CLIとのバージョン齟齬によって
client version ... is too new. Maximum supported API version is 1.42といったエラーが発生することがあります。その場合はホストのDockerを更新するか、READMEに記載の通り--env DOCKER_API_VERSION=1.42のような環境変数を渡して実行する必要があります。 - ポートとネットワークセキュリティ: インストーラーは
127.0.0.1:20080でのみ待ち受けを行います。リモートサーバーにセルフホスト導入を行う場合は、ポートを全インターフェースに開放せず、SSHトンネル(127.0.0.1:20080経由)を利用してアクセスすることが推奨されています。 - 初回起動時の所要時間: 非Linuxのネイティブホスト(macOSやWindowsなど)では、コンテナ環境の差異によりインストール完了後のサーバー起動に数分を要する場合があります。
- 過去バージョンからのアップグレード: 既存環境をアップグレードする際は、通常のコンテナ起動ではなくマイグレーションツールを用いたデータ移行手順を踏む必要があります。
まとめ
Appwriteは、認証やDB、ストレージなどWeb・モバイルアプリ開発に必要な機能を網羅したオープンソースの統合バックエンドです。MCP連携を通じてCursorやClaude CodeなどのAIエージェントからも直接リソース操作が可能になっており、次世代の開発ワークフローに適応しています。Dockerを用いたセルフホストまたはマネージドなCloud環境の双方から、要件に応じたインフラ構成を選択できます。





