Admin MCP

🚀 @hellocoop/admin-mcp (BETA)

Model Context Protocol (MCP)サーバーで、Hellōアプリケーションの作成と管理を行います。

🚧 BETAステータス: このMCPサーバーは現在ベータ版です。フィードバックを積極的に求めており、コントリビューションも歓迎します！問題の報告、改善提案、またはプルリクエストを提出して、開発者体験の向上にご協力ください。

🚀 クイックスタート

📦 インストール

📖 完全なドキュメントとインストールガイド

クイック設定

以下の設定のいずれかをMCPクライアント設定にコピーします。

NPMパッケージ（最新版）:

{
  "hello-admin-stdio": {
    "command": "npx",
    "args": ["-y", "@hellocoop/admin-mcp@latest"],
    "type": "stdio"
  }
}

HTTPトランスポート（リモート）:

{
  "hello-admin-http": {
    "url": "https://admin-mcp.hello.coop/",
    "type": "http"
  }
}

📖 ローカル開発のセットアップ を参照して、ソースから実行する方法を確認してください。

💻 使用例

このMCPサーバーは、強力なツール (hello_manage_app) を提供しており、AIアシスタントから直接Hellōアプリケーションの作成と管理ができます。従来のAPIとは異なり、すべての操作に自動的に完全な開発者コンテキスト - プロフィール、チーム、およびアプリケーション - が含まれるため、AIアシスタントに最適です。

📖 詳細な使用方法、例、およびトラブルシューティングについては、hello.dev/docs/admin-mcp をご覧ください。

✨ 主な機能

• 🏢 コンテキスト認識操作: すべてのツール呼び出しに自動的に現在の開発者プロフィール、チーム、およびアプリケーションが含まれ、シームレスなコンテキストを提供します。
• 📱 統一されたアプリケーション管理: すべてのアプリケーション操作（作成、読み取り、更新、シークレット管理、ロゴ管理）に対応する強力な単一ツール。
• 🔐 安全なOAuth統合: JWTトークン検証を備えたブラウザベースの認証。
• 🌐 複数のトランスポートサポート: stdio（ローカル）とHTTP（リモート）の両方のMCPトランスポートで動作します。
• 📊 組み込みアナリティクス: 使用状況の追跡とパフォーマンスの監視による最適化。
• 🎨 ロゴ管理: 自動的な明/暗テーマサポート付きでロゴをアップロードできます。
• ⚙️ 環境の柔軟性: ドメインと管理サーバーを設定可能。

利用可能なツール

🎯 コアツール:

• hello_manage_app - すべてのアプリケーション管理の主要ツール
  • アクション: create, read, update, create_secret, update_logo_from_data, update_logo_from_url
  • 常に含まれる情報: すべてのレスポンスに現在のプロフィール、チーム、およびアプリケーションが含まれます。
  • 自動コンテキスト: 指定されていない場合は、自動的にデフォルトのチームが使用されます。
  • スマートなデフォルト: 提供されていない場合は、プロフィールからアプリ名が生成されます。

主な利点

🔄 常にコンテキストを保持: 従来のAPIとは異なり、すべてのツールのレスポンスに完全な開発者コンテキストが含まれます。

• ユーザープロフィール（名前、メールアドレス、画像）
• すべてのチーム/組織と役割
• すべてのアプリケーションとチームの関連付け
• 現在のチームとアプリケーションの状態

これにより、操作間でコンテキストを失うことがなく、完全な開発環境を理解する必要のあるAIアシスタントに最適です。

ツールのアクションとレスポンス構造

hello_manage_app のアクション:

📝 create - 新しいアプリケーションを作成します。

• 存在しない場合は自動的にチームが生成されます。
• プロフィールからスマートなデフォルト名が生成されます。
• 返り値: { profile, application, action_result }

👁️ read - アプリケーションの詳細を読み取ります。

• client_id がない場合: 完全なプロフィールコンテキストが返されます。
• client_id がある場合: プロフィール + 特定のアプリケーションが返されます。
• 返り値: { profile, application?, action_result }

✏️ update - アプリケーションの設定を更新します。

• アプリケーションの任意のプロパティを変更できます。
• 返り値: { profile, application, action_result }

🔑 create_secret - クライアントシークレットを生成します。

• 安全なOAuthクライアントシークレットが作成されます。
• 返り値: { profile, application, client_secret, action_result }

🎨 update_logo_from_data - base64データからロゴをアップロードします。

• 明/暗テーマが自動的にサポートされます。
• アプリケーションにロゴURLが自動的に更新されます。
• 返り値: { profile, application, update_result, action_result }

🔗 update_logo_from_url - URLからロゴをアップロードします。

• 提供されたURLからロゴを取得してアップロードします。
• 明/暗テーマがサポートされます。
• 返り値: { profile, application, update_result, action_result }

すべてのレスポンスには完全なプロフィールコンテキストが含まれており、開発環境を把握する必要のあるAIアシスタントに最適です。

利用可能なリソース

• Hellōドキュメント - 完全な統合ドキュメント
• Hellōクイックスタート - フレームワーク固有のセットアップガイド
• Hellōボタン - ログインボタンの実装ガイド
• Hellōスコープ - 利用可能なスコープとクレームのリファレンス
• HellōウォレットAPI - ウォレットAPIのリファレンスドキュメント
• Hellōロゴデザインガイドライン - テーマに適したロゴを作成するための包括的なガイド

環境変数

• HELLO_DOMAIN: デフォルトのドメインを上書きします（デフォルトは hello.coop）
• HELLO_ADMIN: 管理サーバーのURLを上書きします（デフォルトは https://admin.hello.coop）

コントリビュートと開発

フィードバックをお待ちしています！ このMCPサーバーはベータ版であり、実際の使用状況に基づいて積極的に改善しています。

コントリビュートの方法

• 🐛 問題の報告: GitHub Issues - バグを見つけた場合や機能要求がある場合はこちらから報告してください。
• 🔧 プルリクエストの提出: GitHub PRs - サーバーの改善にご協力ください。
• 💬 ディスカッションへの参加: Discord - フィードバックを共有し、助けを求めることができます。

ローカル開発

ローカル開発とテストのためには、以下の手順を実行します。

# リポジトリをクローンする
git clone https://github.com/hellocoop/admin-mcp
cd admin-mcp

# 依存関係をインストールする
npm install

その後、AIクライアントを設定して、ローカルバージョンを実行します。

ローカル開発（Node.js）:

{
  "hello-admin-local": {
    "command": "node",
    "args": ["path/to/HelloCoop/admin-mcp/src/stdio.js"],
    "type": "stdio"
  }
}

テスト

包括的なテストスイートを実行します。

# すべての自動テストを実行する
npm test