ポートMCPサーバー

Port.io API用の Model Context Protocol (MCP) サーバー。これにより、Claude は自然言語を使用して Port.io の開発者プラットフォーム機能を操作できるようになります。

Port MCPでできること

自然言語を使用して Port.io での作業方法を変革します。

情報を素早く見つける

• エンティティの詳細を取得- 「サービス X の所有者は誰ですか?」

• オンコールステータスを確認する- 「現在誰がオンコールですか?」

• カタログの分析情報を取得- 「運用中のサービスはいくつありますか?」

スコアカードを分析する

• 弱点を特定する- 「ゴールド レベルを達成できないサービスはどれですか。その理由は?」

• コンプライアンス ステータスを取得する- 「セキュリティ要件を満たしていないすべてのサービスを表示する」

• 品質の向上- 「次のスコアカード レベルに到達するには何を修正する必要がありますか?」

リソースを作成する

• スコアカードの作成- 「ベーシック、シルバー、ゴールドのレベルで「セキュリティ態勢」という新しいスコアカードを作成します」

• ルールを定義する- 「シルバー レベルに到達するには、サービスにチーム オーナーが必要であることを要求するルールを追加します」

• 品質ゲートの設定- 「サービスに適切なドキュメントがあるかどうかを確認するルールを作成する」

Port MCPの機能は継続的に拡張されています。ご提案がありましたら、ロードマップに関するフィードバックをお待ちしております。

インストール

ポートの資格情報を取得する

1. Port.io アカウントを作成します:

   • Port.ioにアクセス

   • アカウントをお持ちでない場合は登録してください

2. API キーを作成します:

   • Port.ioダッシュボードに移動します

   • 「設定」>「認証情報」に移動します

   • クライアントIDとクライアントシークレットの両方を保存します

クロードデスクトップ

claude_desktop_config.jsonに以下を追加します。

ドッカー

カーソル

カーソル設定で構成します。

• カーソル設定 > MCPサーバーに移動します

• 設定:

  • 名前 - Port

  • タイプ - Command

  • コマンド - /path/to/your/file/run-port-mcp.sh

####ドッカー

利用可能なツール

ブループリントツール

1. get_blueprints

   • ポートからすべての設計図のリストを取得します

   • オプション入力:

     • detailed （ブール値、デフォルト：false）：各ブループリントの完全なスキーマの詳細を返します。

   • 戻り値: 利用可能なすべてのブループリントのフォーマットされたテキスト表現

2. get_blueprint

   • 特定のブループリントの識別子による情報を取得する

   • 必要な入力:

     • blueprint_identifier (文字列): 取得するブループリントの一意の識別子

   • オプション入力:

     • detailed （ブール値、デフォルト：true）：完全なスキーマの詳細を返す

3. create_blueprint

   • 港で新しい設計図を作成する

   • 必要な入力:

     • 識別子、タイトル、プロパティなどのさまざまなフィールド。

   • 戻り値: 作成されたブループリントオブジェクト

4. update_blueprint

   • 既存のブループリントを更新する

   • 必要な入力:

     • identifier （文字列）：更新するブループリントの一意の識別子

     • 更新するさまざまなフィールド

   • 戻り値: 更新されたブループリントオブジェクト

5. delete_blueprint

   • ポートからブループリントを削除する

   • 必要な入力:

     • blueprint_identifier (文字列): 削除するブループリントの一意の識別子

   • 戻り値: 成功ステータス

エンティティツール

1. get_entities

   • 指定されたブループリントのすべてのエンティティを取得します

   • 必要な入力:

     • blueprint_identifier (文字列): エンティティを取得するブループリントの識別子

   • オプション入力:

     • detailed （ブール値、デフォルト：false）：プロパティを含む完全なエンティティの詳細を返す

2. get_entity

   • 特定のエンティティに関する情報を取得する

   • 必要な入力:

     • blueprint_identifier (文字列): エンティティが属するブループリントの識別子

     • entity_identifier (文字列): 取得するエンティティの一意の識別子

   • オプション入力:

     • detailed （ブール値、デフォルト：true）：完全なエンティティの詳細を返す

3. create_entity

   • 特定のブループリントの新しいエンティティを作成する

   • 必要な入力:

     • blueprint_identifier (文字列): エンティティを作成するためのブループリントの識別子

     • entity （オブジェクト）：ブループリントスキーマに従ったエンティティデータ

4. update_entity

   • 既存のエンティティを更新する

   • 必要な入力:

     • blueprint_identifier (文字列): エンティティが属するブループリントの識別子

     • entity_identifier (文字列): 更新するエンティティの一意の識別子

     • entity （オブジェクト）：更新されたエンティティデータ

5. delete_entity

   • エンティティを削除する

   • 必要な入力:

     • blueprint_identifier (文字列): エンティティが属するブループリントの識別子

     • entity_identifier (文字列): 削除するエンティティの一意の識別子

   • オプション入力:

     • delete_dependents (ブール値、デフォルト: false): trueの場合、すべての依存関係も削除します

スコアカードツール

1. get_scorecards

   • ポートからすべてのスコアカードを取得する

   • オプション入力:

     • detailed （ブール値、デフォルト：false）：完全なスコアカードの詳細を返す

2. get_scorecard

   • 特定のスコアカードの情報をその識別子で取得する

   • 必要な入力:

     • scorecard_id (文字列): 取得するスコアカードの一意の識別子

     • blueprint_id (文字列、オプション): スコアカードが属するブループリントの識別子

3. create_scorecard

   • 特定のブループリントの新しいスコアカードを作成する

   • 必要な入力:

     • blueprint_id (文字列): スコアカードを作成するブループリントの識別子

     • identifier （文字列）：新しいスコアカードの一意の識別子

     • title (文字列): スコアカードの表示タイトル

     • levels （リスト）: スコアカードのレベルのリスト

   • オプション入力:

     • rules （リスト）: スコアカードのルールのリスト

     • description (文字列): スコアカードの説明

4. update_scorecard

   • 既存のスコアカードを更新する

   • 必要な入力:

     • blueprint_identifier (文字列): スコアカードが属するブループリントの識別子

     • scorecard_identifier (文字列): 更新するスコアカードの一意の識別子

     • 更新するさまざまなフィールド (タイトル、レベル、ルールなど)

   • 戻り値: 更新されたスコアカードオブジェクト

5. delete_scorecard

   • ポートからスコアカードを削除する

   • 必要な入力:

     • blueprint_identifier (文字列): スコアカードが属するブループリントの識別子

     • scorecard_identifier (文字列): 削除するスコアカードの一意の識別子

   • 戻り値: 成功ステータス

AIエージェントツール

1. invoke_ai_agent

   • 特定のプロンプトでPort AIエージェントを呼び出す

   • 必要な入力:

     • prompt (文字列): AIエージェントに送信するプロンプト

   • 戻り値: AIエージェントからの呼び出しステータスとメッセージ

フィードバックとロードマップ

Port MCP は継続的に改善されており、皆様からのご意見をお待ちしております。フィードバックや機能リクエストは、ロードマップページからお寄せください。

トラブルシューティング

認証エラーが発生した場合は、次の点を確認してください。

1. ポートの資格情報は引数に正しく設定されています

2. 必要な権限を持っています

3. 資格情報は構成に適切にコピーされています

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。