AnythingMCPの始め方

AnythingMCPとは？

AnythingMCPは、REST、SOAP、GraphQL APIおよびデータベースをMCP（Model Context Protocol）サーバーに変換するオープンソースのゲートウェイです。接続が完了すると、Claude、ChatGPT、Copilot、またはMCP互換のクライアントを介してシステムと対話できます。

前提条件

• Docker と Docker Compose — Dockerをインストール
• Git — リポジトリをクローンするため
• ターミナル — macOSまたはLinuxのbash

Dockerなしでのローカル開発（オプション）:

• Node.js 22+
• npm

クイックスタート

1. リポジトリをクローンする

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp

2. セットアップスクリプトを実行する

bash setup.sh

インタラクティブウィザードが完全な構成をガイドします：

ステップ 1 — デプロイメントモード Docker（本番環境向け推奨）またはローカル開発のいずれかを選択します。

ステップ 2 — ドメインとポート ホスト名を入力します。ローカル使用の場合はデフォルトのlocalhostを維持します。本番環境の場合はドメイン（例：mcp.example.com）を入力すると、スクリプトがCaddyをリバースプロキシとして自動的にLet's Encrypt SSLで構成します。

ステップ 3 — シークレット すべてのセキュリティ資格情報は自動的に生成されます：

• 認証用のJWTシークレット
• 機密データ用の暗号化キー
• データベースパスワード
• NextAuthシークレット

ステップ 4 — MCP認証 AIエージェントがMCPエンドポイントに認証する方法を選択します：

• OAuth 2.0（推奨）
• APIキー / ベアラートークン（レガシー）
• 両方（OAuth + レガシーフォールバック）
• なし（開発専用）

ステップ 5 — メール（オプション） ユーザー確認、招待、およびパスワードリセットのためにSMTPを構成します。

ステップ 6 — Redis（オプション） レート制限とレスポンスキャッシングのためにRedisを有効にします。

スクリプトは.envファイルを生成し、Docker Composeを構成し、すべてのサービスを自動的に起動します。

3. ダッシュボードを開く

セットアップが完了したら、ダッシュボードを開きます：

• ローカル: http://localhost:3000
• ドメイン使用時: https://mcp.example.com

管理者アカウントを登録する — 最初に登録したユーザーが管理者になります。

最初のAPIを接続する

1. ダッシュボードにログインする
2. コネクタを作成をクリックする
3. コネクタの種類を選択する（REST、SOAP、GraphQL、またはデータベース）
4. 接続を構成する（OpenAPI仕様、WSDLをインポートするか、データベース資格情報を入力する）
5. 保存してアクティブにする

あなたのMCPエンドポイントは次の場所に準備されています：

http://localhost:4000/mcp

AIエージェントを接続する

あなたのMCPサーバーを任意の互換性のあるAIクライアントに追加します。Claude Desktopの例（またはClaude.ai → コネクタに直接サーバーURLを追加）：

{
  "mcpServers": {
    "my-server": {
      "url": "http://localhost:4000/mcp"
    }
  }
}

アーキテクチャ

AnythingMCPは、2つのサービスを持つ単一のコンテナとして実行されます：

追加のサービス：

• PostgreSQL 17 — コネクタ、ユーザー、および構成を保存
• Caddy（オプション） — 自動SSLを持つリバースプロキシ
• Redis（オプション） — レート制限とレスポンスキャッシング

よく使うコマンド

# ログを表示
docker compose logs -f

# サービスを再起動
docker compose restart

# サービスを停止
docker compose down

# 最新バージョンに更新
git pull && docker compose up -d --build

次のステップ

• MCPとは？ — Model Context Protocolを理解する
• REST APIをMCPに — 最初のREST APIを接続する
• データベースをMCPに — データベースを直接接続する
• Hetznerにデプロイ — SSL付きの本番デプロイ
• AWSにデプロイ — EC2にデプロイ