AppCrane

appcrane-mcp

AppCrane 用のスタンドアロン MCP コネクターです。AppCrane は、AI が構築し、エージェントがデプロイするアプリ向けのセルフホスト可能なデプロイプラットフォームです。

AppCrane は <instance>/api/mcp に MCP サーバーを公開し、X-API-Key を必要とします。このパッケージは、次の機能を備えた薄型の stdio MCP サーバーです。

1. 設定不要で tools/list の情報を取得できる、appcrane_* ツールカタログ全体を提供します。同梱の catalog.json を利用するため、レジストリやサンドボックス（Glama など）は、コンテナー内で起動してオフラインで情報を取得できます。
2. APPCRANE_URL と APPCRANE_KEY を設定すると、実際の tools/call をお客様の AppCrane インスタンスにプロキシします。

npx appcrane-mcp を使って、Node 20+ が利用可能な環境であればどこでも実行できます。

ライセンス： このコネクターは MIT ライセンスです。接続先の AppCrane プラットフォームは別の プロジェクトであり、ライセンスは AGPL-3.0 です。このパッケージをインストールしてもプラットフォームはインストールされません。この コネクターは、お客様がセルフホストする AppCrane インスタンスに接続するクライアントです。

接続方法

ホステッドサービスも AppCrane アカウントも必要ありません。手順はすべてお客様自身で行います。

1. お客様が管理する環境に AppCrane（AGPL）をセルフホストします。
2. そのインスタンスから API キーを発行します。
3. お客様のエージェントが、このコネクターをローカルで stdio 経由で実行します（npx -y appcrane-mcp）。
4. コネクターは、各 tools/call をお客様の X-API-Key とともに ${APPCRANE_URL}/api/mcp に転送します。API キーはお客様自身の MCP クライアント設定内に保持され、設定したインスタンス URL 以外に送信されることはありません。

インストール／実行

npx appcrane-mcp

環境変数を設定しなくても起動し、同梱カタログ（57 個のツール）から tools/list に応答します。お客様のインスタンスに対してツールを実際に呼び出すには、次のように設定します。

環境変数	必須	説明
APPCRANE_URL	呼び出し時に必要	インスタンスのベース URL（例：https://crane.example.com）
APPCRANE_KEY	呼び出し時に必要	AppCrane API キー（X-API-Key として送信）
APPCRANE_GITHUB_TOKEN	任意	github_* パススルーツールを利用するための GitHub PAT（X-Github-Token として送信）

MCP クライアントの設定

これは stdio コマンドサーバーであり、HTTP エンドポイントではありません。次のように MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "appcrane": {
      "command": "npx",
      "args": ["-y", "appcrane-mcp"],
      "env": {
        "APPCRANE_URL": "https://crane.example.com",
        "APPCRANE_KEY": "your_api_key",
        "APPCRANE_GITHUB_TOKEN": "ghp_optional_for_github_passthrough"
      }
    }
  }
}

Claude Code CLI：

claude mcp add appcrane \
  --env APPCRANE_URL=https://crane.example.com \
  --env APPCRANE_KEY=your_api_key \
  -- npx -y appcrane-mcp

動作の仕組み

• tools/list
  • APPCRANE_URL と APPCRANE_KEY が設定されている場合 → ${APPCRANE_URL}/api/mcp に接続し（StreamableHTTP、ヘッダー X-API-Key、GitHub トークンが設定されている場合は X-Github-Token も使用）、認証に基づいてフィルターされた最新のツール一覧を取得して返します。インスタンスに到達できない場合は、同梱カタログにフォールバックします。
  • 未設定の場合 → 同梱の静的カタログ（catalog.json）を返します。この方法では環境変数が不要なため、レジストリの情報取得用サンドボックスでも利用できます。
• tools/call → APPCRANE_URL と APPCRANE_KEY が必要です。呼び出しをバックエンドに転送し、その結果を返します。設定されていない場合は、「not configured」という明確なエラーを返します。

Docker

docker build -t appcrane-mcp .

# Introspection only (no config) — starts and serves tools/list:
docker run -i --rm appcrane-mcp

# Full use:
docker run -i --rm \
  -e APPCRANE_URL=https://crane.example.com \
  -e APPCRANE_KEY=your_api_key \
  appcrane-mcp

開発

npm install
npm run build          # tsc -> dist/
npm run gen:catalog    # regenerate catalog.json from the AppCrane platform source
npm run check:catalog  # fail if catalog.json has drifted from that source
node scripts/test-list.mjs   # smoke test: spawn over stdio, assert tools/list

どちらのカタログスクリプトも、プラットフォーム側の getToolCatalog() を、隣接する deployhub チェックアウトからインポートします。配置場所が異なる場合は、APPCRANE_SRC にその server/services/mcpTools.js のパスを設定してください。

リリース

package.json の version を更新してコミットし、一致するタグをプッシュします。

git tag v1.7.1 && git push origin v1.7.1

.github/workflows/publish.yml は npm Trusted Publishing を使って npm に公開します。npm トークンもワンタイムパスワードも不要で、npm はプロベナンス（ビルド元のコミット）を添付します。 このワークフローは、package.json と一致しないタグを拒否し、公開前にカタログをプラットフォームの最新の main と照合するため、古い catalog.json が公開されることはありません。（以前、気付かれないまま古くなったことがありました。プラットフォームに対してツールが22個不足し、実際には57個あるところを35個とうたっていました。） CI より先に確認できるよう、まずローカルで npm run check:catalog を実行してください。

同じタグによって、公式の MCP Registry にも、OIDC を使って io.github.gitayg/appcrane としてバージョンが登録されます。package.json と合わせて、server.json の version と packages[0].version も更新してください。このワークフローは、3つすべてと一致しないタグを拒否します。 （自動化されるまでは、npm のバージョンが進んでも登録は1.0.0のままでした。）

同梱の catalog.json は、AppCrane プラットフォームの実際のツール定義（deployhub/server/services/mcpTools.js）から生成され、AWS に準拠したツールの語彙（appcrane_set_secret、appcrane_get_secret、appcrane_cp、および stage パラメーター）を反映しています。パッケージを単体で利用できるよう、コミットされています。

AppCrane について

AppCrane は、AI が構築・デプロイしたアプリ向けのセルフホスト可能なホームです。このコネクターは普及を最大限に促すため MIT ライセンスで公開されています。プラットフォーム自体は AGPL です。

• このコネクター（MIT）：https://github.com/gitayg/appcrane-mcp
• プラットフォーム（AGPL-3.0）：https://github.com/gitayg/appCrane
• 製品ページ：https://glick.run/appcrane.html