English | 日本語

クイックスタート - 5 分で MCP サーバーを試す¶

このガイドでは、MCP サーバーを起動してテストするまでの最短手順を説明します。

1. サーバー起動 (1 分)¶

docker compose up -d

起動を待つ:

docker compose logs -f web

Default admin user created が表示されたら起動完了です。

2. 管理画面でログイン (1 分)¶

ブラウザで https://localhost/ を開く（ポート番号なし。自己署名証明書の警告が出るので「詳細」→「アクセスする」で進む。Caddy がリバースプロキシをするため、ポート 5000 はホストには公開されていない）
ログイン:
ID: admin
パスワード: admin

3. テストサービスを作成 (2 分)¶

3.1 サービス登録¶

ダッシュボード → 「サービス管理」
「新規サービス登録」をクリック
入力:
サービス名: Weather Service
サブドメイン: weather
説明: Test weather service
「登録」をクリック

3.2 Capability 登録¶

作成したサービスをクリック
「Capabilities 管理」をクリック
「新規 Capability 登録」をクリック
入力:
Capability 名: echo_test
接続タイプ: API
接続先 URL: https://httpbin.org/post
説明: Simple echo test
Body パラメータ:
```
message: Hello
```
「登録」をクリック

3.3 管理者に権限付与¶

ダッシュボード → 「ユーザー管理」
「管理者」をクリック
「権限を追加」をクリック
サービス: Weather Service
Capability: echo_test
「追加」をクリック

3.4 Bearer トークン取得¶

同じユーザー詳細画面で、Bearer トークンをコピーします。

4. MCP エンドポイントをテスト (1 分)¶

4.1 Capabilities 取得¶

# TOKENを置き換えてください
TOKEN="YOUR_BEARER_TOKEN_HERE"

curl -k -H "Authorization: Bearer $TOKEN" \
  https://weather.lvh.me/mcp

期待される出力:

{
  "capabilities": {
    "tools": [
      {
        "name": "echo_test",
        "description": "Simple echo test",
        "inputSchema": {
          "type": "object",
          "properties": {
            "message": {
              "type": "string",
              "description": "Parameter: message",
              "default": "Hello"
            }
          }
        }
      }
    ]
  },
  "serverInfo": {
    "name": "Weather Service",
    "version": "1.0.0"
  }
}

4.2 Tool 実行¶

curl -k -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"arguments": {"message": "Test from MCP"}}' \
  https://weather.lvh.me/tools/echo_test

期待される出力:

{
  "content": [
    {
      "type": "text",
      "text": "{\"success\": true, \"status_code\": 200, \"data\": {...}}"
    }
  ],
  "isError": false
}

完了! 🎉¶

これで以下ができるようになりました:

✅ MCP サーバーの起動
✅ Web 管理画面からサービス・Capability・権限の管理
✅ サブドメインベースの MCP エンドポイントへのアクセス
✅ Tool の実行とレスポンスの確認

次のステップ¶

実際の API を統合する¶

Web 管理画面で新しい Capability を作成
実際の API URL (OpenWeather, GitHub, など) を設定
API Key をヘッダーパラメータに設定
ユーザーに権限を付与
MCP クライアント (Dify, Claude Desktop) から利用

複数のサービスを管理¶

各 API ごとにサービスを作成
サブドメインで分離 (weather, github, database, etc.)
ユーザーごとに異なる権限を設定

MCP サーバーの中継¶

他の MCP サーバーを Capability として登録
タイプを「MCP」に設定
複数の MCP サーバーを 1 つに統合

トラブルシューティング¶

lvh.me が動作しない¶

代わりに以下を使用:

curl -k -H "Authorization: Bearer $TOKEN" \
  https://localhost/mcp?subdomain=weather

`https://localhost/` で証明書の警告が出る¶

Caddy が自動生成する自己署名証明書のため、ローカル開発では想定どおりの動作です。ブラウザの警告画面で「詳細」→「アクセスする」と進めば問題なく使えます。警告を消したい場合はスケーリング・コンテナ構成を参照してください。

Docker を使わず直接 `python run.py` で起動した場合¶

ポート 5000・http（TLSなし）でアクセスしてください: http://localhost:5000/ 、http://weather.lvh.me:5000/mcp のように読み替えます。

権限エラーが出る¶

ユーザー詳細画面で権限が正しく設定されているか確認
Capability 名が正しいか確認
サブドメインが正しいか確認

データベースエラー¶

# コンテナを再起動
docker compose restart

# または完全に再ビルド
docker compose down
docker compose up -d --build

その他のドキュメント¶

詳細な使い方: SETUP.md
MCP エンドポイント詳細: MCP_ENDPOINTS.md
プロジェクト概要: README.md