Port MCP Server

ポート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ファイルをご覧ください。