LinkedIn MCP Server

HAPI MCP – Model Context Protocol 向けヘッドレス API

AI のためにシステムを書き直す必要はありません。API を瞬時に MCP サーバーに変換できます。

HAPI MCP は、OpenAPI カタログを自動的に MCP ツールに変換し、設計（OAS/Arazzo）と実行時（エージェント/LLM）を明確に分離します。既存の API が AI 対応のツールになります。新しいビジネスロジックも、サイドカーサーバーも、作り直しも必要ありません。

主な機能

• 書き直し不要： API ロジックを 100％再利用できます。OpenAPI を入力すれば、MCP ツールが出力されます。並行するコードベースやシャドーサービスは不要です。
• 価値実現までの時間を短縮： 仕様を数分でエージェント対応のツールに変換できます。仕様を更新すれば、新しいツールをすぐにリリースできます。
• リスクを軽減： 権限、認証、レート制限、監査可能性は API から引き継がれます。後付けの仕組みなしでガバナンスを実現できます。
• ニーズに合わせて拡張： runMCP は、必要に応じて長時間実行にも対応しながら、サーバーレスのような柔軟なスケーリングを実現します。コールドスタートは高速で、スループットが必要な間はウォーム状態を維持します。
• 決定論的なオーケストレーション： OrcA は、複数のツールを使うタスクを予測可能な方法で計画し、実行します。脆弱なプロンプトチェーンは不要です。
• ベンダーに依存しない： ChatGPT、Claude、QBot、chatMCP など、あらゆる MCP クライアントで動作します。OAS、MCP、Arazzo のポータビリティも維持されます。

仕組み

1. API 仕様を選択する

   • OpenAPI、Swagger、REST など、HAPI CLI はあらゆる API 仕様形式に対応します。
   • OpenAPI 3.0 以降、REST API、OAuth 2.0 Dynamic Client Registration に対応しています。

2. コマンドを 1 つ実行する

   • シンプルな CLI コマンド 1 つで、API をすぐに使える MCP サーバーに変換します。
   • 複雑なセットアップは不要で、設定ゼロ、どこでも動作し、クロスプラットフォームに対応します。

3. すぐに使う

   • API がツール、AI エージェント、またはテスト用インターフェースとして使えるようになります。
   • MCP サーバーとしてすぐに利用でき、AI エージェントとの互換性があり、テスト用インターフェースとしても使え、開発者にとって使いやすい設計です。

ビジュアルパイプライン

API Spec (swagger.json) → HAPI CLI → Usable Tool (AI-ready) ← MCP Clients

[ OpenAPI / Swagger ]       [ HAPI CLI ]        [ MCP Server ]
       (Your API)         →   (Transform)   →   (Usable Tool)
                                                 ↑          ↑
                                                 |          |
                                          [ ChatGPT ]  [ runMCP ]
                                          [ Claude  ]  [ OrcA   ]
                                          [ QBot    ]  [ chatMCP]
                                          [ Agents  ]

HAPI のメリットを得られる人

• 経営幹部： コストを膨らませずに AI 導入を進められます。書き直しや統合の複雑化ではなく、成果にチームの集中を維持できます。
• アーキテクトと PM： OpenAPI/Arazzo で設計し、MCP で実行できます。明確なコントラクト、ポリシーの継承、バージョン管理されたワークフローにより、リスクを低く抑えられます。
• エンジニアと運用担当者： 一度デプロイすれば完了です。HAPI Server と runMCP がツールをスケーリングし、QBot/chatMCP が迅速なフィードバックを提供し、OrcA が実行を決定論的に保ちます。

すでに連携済みのスタック

• HAPI Server： OpenAPI を自動的に MCP ツールに変換します。コントラクトは信頼できる情報源と同期した状態を保ちます。
• runMCP： MCP ツールの実行とテストを自動スケーリングします。コールドスタートは高速で、ワークフローが長時間実行される場合はウォーム状態を維持します。
• QBot： パワーユーザーがターミナルやスクリプトから MCP ツールを直接操作できる CLI TUI です。
• chatMCP： サポート、運用、社内アシスタント向けに、MCP をネイティブに扱う会話型クライアントです。
• OrcA： 複数のツールを使うタスクを決定論的に計画、オーケストレーションします。脆弱なプロンプトの継ぎ接ぎは不要です。
• エージェント： 標準 API からエージェント型システムを構築できます。独自の接着コードは不要です。プラットフォームをまたいで MCP クライアントを接続できます。

デモ

• デモのプレイリスト
• API ファーストと MCP のデモを紹介する新しい HAPI MCP YT チャンネル

ドキュメント

• ドキュメントを見る
• HAPI Server を見る

よくある質問

• サービスを書き換える必要がありますか？
  いいえ。HAPI MCP は、既存の OpenAPI 仕様をそのまま MCP ツールに変換します。認証、検証、ビジネスルールは変更されません。

• これは単なる別の MCP サーバーですか？
  これは ヘッドレス API モデルです。API がランタイムになります。HAPI Server は API を MCP として反映し、runMCP がスケーリングし、OrcA がオーケストレーションします。ロジックの重複はありません。

• どのクライアントがツールを利用できますか？
  あらゆる MCP クライアントに対応します。ChatGPT、Claude、QBot、chatMCP、独自のオーケストレーターなど、ベンダーに依存しない設計です。

• 制御とコンプライアンスを維持するにはどうすればよいですか？
  API が引き続き唯一の信頼できる情報源です。ポリシー、RBAC、レート制限、監査ログは自動的に引き継がれます。隠れたロジックはありません。

• セキュリティとプライバシーについてはどうですか？
  スコープ付き認証情報、ツールごとの権限、監査可能な呼び出しは、API レイヤーから引き継がれます。HAPI は、規制対象の環境向けにガードレールと可観測性を追加します。

• どれくらい早く始められますか？
  5 分以内に、最初の API を MCP ツールに変換できます。HAPI CLI を使えば、すばやく簡単に始められます。

はじめに

1. 最新リリースから HAPI CLI をインストールします：https://github.com/la-rebelion/hapimcp/releases

2. 1 つのコマンドで OpenAPI 仕様を MCP サーバーに変換します：

   hapi serve path/to/your/swagger.json --headless
   

3. 互換性のあるクライアントで MCP ツールを使い始めましょう！

4. 高度な使い方やベストプラクティスについては、ドキュメントをご覧ください。

コントリビュート

コントリビュートを歓迎します！GitHub でディスカッションを開始するか、プルリクエストを送信してください：https://github.com/la-rebelion/hapimcp

ライセンス

HAPI MCP は MIT License の下でライセンスされています。詳細は LICENSE をご覧ください。