Oss Autopilot

@oss-autopilot/mcp

OSS Autopilot 用の MCP サーバーです。PR の追跡、課題の発見、コントリビューション管理を MCP ツールとして提供し、MCP 対応クライアントから利用できます。

提供機能

機能	数	説明
ツール	30	daily、status、search、features、vet、vet-list、verify-issue、track、compliance-score、repo-vet、strategy、comments、post、claim、config、init、setup、check-setup、startup、dismiss、undismiss、move、state-show、state-sync、state-unlink、guidelines-list、guidelines-get、guidelines-store、guidelines-reset、guidelines-fetch-corpus
リソース	6	oss://status、oss://config、oss://prs、oss://prs/shelved、oss://pr/{owner}/{repo}/{number}、oss://repo/{owner}/{repo}/guidelines
プロンプト	4	triage（PR の優先順位付け）、respond-to-pr（返信の下書き作成）、find-issues（課題の発見）、extract-learnings（過去の PR フィードバックからリポジトリごとのガイダンスを抽出）

stdio（デフォルト）および Streamable HTTP トランスポートに対応しています。

前提条件

• Node.js 22+
• 認証済みの GitHub CLI（gh auth login）

クイックスタート

# 1. Add the server to your MCP client (see config examples below)

# 2. From your MCP client, call the `init` tool once with your GitHub username
#    (this writes ~/.oss-autopilot/state.json).

# 3. Use the other tools — e.g. `daily` to check your PRs, `search` to find issues.

クライアントの設定

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "oss-autopilot": {
      "command": "npx",
      "args": ["@oss-autopilot/mcp@latest"]
    }
  }
}

Cursor

プロジェクトまたはグローバル設定の .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "oss-autopilot": {
      "command": "npx",
      "args": ["@oss-autopilot/mcp@latest"]
    }
  }
}

Codex CLI

codex mcp add oss -- npx @oss-autopilot/mcp@latest

Windsurf

Windsurf の MCP 設定に追加します。

{
  "mcpServers": {
    "oss-autopilot": {
      "command": "npx",
      "args": ["@oss-autopilot/mcp@latest"]
    }
  }
}

Streamable HTTP（任意のクライアント）

stdio の代わりに HTTP モードでサーバーを実行します。

npx @oss-autopilot/mcp@latest --http --port 3001

サーバーは http://127.0.0.1:3001/mcp でリッスンし、POST リクエストを受け付けます。

認証

HTTP モードでは、すべてのリクエストにベアラートークンが必要です（stdio モードでは不要です。親プロセスの ID を引き継ぎます）。初回の --http 起動時に、サーバーはランダムな 32 バイトのトークンを生成し、0600 権限で ~/.oss-autopilot/mcp.token に書き込みます。起動時に、パスと「新規生成」を示すマーカーが stderr に記録されます。

すべての HTTP クライアントは、次のヘッダーを送信する必要があります。

Authorization: Bearer <contents of ~/.oss-autopilot/mcp.token>

有効な Authorization ヘッダーがないリクエストには 401 が返されます。RFC 7235 に従い、Bearer スキームでは大文字と小文字が区別されません。トークン値自体は、定時間でバイト単位に比較されます。ループバック以外の Host ヘッダーを持つリクエストには 403 が返されます（DNS リバインディング対策）。リクエストでは、数値の Content-Length を指定し、その値は 1 MiB 以下である必要があります。Content-Length がない場合、数値以外の場合、または上限を超える場合は 413 が返されます。

トークンは再起動後も保持されます。ローテーションするには、ファイルを削除して再起動します。新しいトークンが生成されます。トークンの保存場所を変更する場合（複数ユーザー環境や CI の設定など）は、サーバーの起動前に OSS_AUTOPILOT_MCP_TOKEN_PATH に任意の絶対パスを設定します。

ツールリファレンス

ツール	説明	読み取り専用
daily	優先順位付きの要約を含む、毎日の PR モニタリングチェックを実行します	いいえ
status	現在の PR 追跡ステータスを表示します	はい
search	貢献できる課題を GitHub で検索します	はい
features	3 件以上の PR がマージされたリポジトリから、機能に関連する機会を見つけます（関連性を基準にします）	はい
vet	貢献に適しているかどうか、課題を分析します	はい
verify-issue	審査前に、課題の状態とリンクされた PR に関する主張を決定論的に検証します	はい
vet-list	キュレーションされた課題リスト内のすべての利用可能な課題を再審査します	いいえ
track	PR を調査します。メタデータの読み取り専用検索のみを行い、追跡や保存はしません	はい
compliance-score	opensource.guide のベストプラクティス（#1245）に照らして PR を評価します	はい
repo-vet	owner/repo のリポジトリ健全性ルーブリック（1～10 点＋判定）を算出します（#1271）	はい
strategy	computeStrategy() を使って、オンデマンドで貢献戦略のスナップショットを取得します（#1243）	はい
comments	PR のコメントを取得して表示します	はい
post	課題または PR にコメントを投稿します	いいえ
claim	コメントを投稿して課題を引き受けます	いいえ
config	設定値を取得または設定します	いいえ
init	GitHub ユーザー名で初期化します	いいえ
setup	言語や関心分野などの設定を行います	いいえ
check-setup	セットアップが完了しているか確認します	はい
startup	起動時チェック（認証、状態、設定）を実行します	いいえ
dismiss	通知から課題を除外します	いいえ
undismiss	除外した課題の通知を再び有効にします	いいえ
move	PR を状態（対応が必要、待機中、保留、自動）間で移動します	いいえ
state-show	現在の状態の永続化モード（ローカルまたは Gist）と同期ステータスを表示します	はい
state-sync	現在の状態を保存先の Gist に強制的にプッシュします	いいえ
state-unlink	Gist による永続化を解除し、ローカルのみのモードに切り替えます	いいえ
guidelines-list	ガイドラインが保存されているリポジトリを一覧表示します（ローカルモードでは常に空です）	はい
guidelines-get	過去の PR フィードバックから抽出した、リポジトリごとの学習ガイドラインを読み込みます	はい
guidelines-store	リポジトリごとのガイドラインを永続化します（上限 8 KB、Gist モードが必要です）	いいえ
guidelines-reset	リポジトリのガイドラインファイルを削除対象として記録します	いいえ
guidelines-fetch-corpus	ホスト側の extract-learnings プロンプトで使用する、生の PR コメント一式を取得します	いいえ

リソースリファレンス

リソース URI	説明
oss://status	PR 追跡ステータス（ローカルにキャッシュされた状態）
oss://config	現在の設定
oss://prs	最後の日次ダイジェストに含まれる、アクティブなオープン PR
oss://prs/shelved	保留中の PR
oss://pr/{owner}/{repo}/{number}	特定の PR の詳細
oss://repo/{owner}/{repo}/guidelines	リポジトリごとの学習ガイドライン（Markdown）

プロンプトリファレンス

プロンプト	引数	説明
triage	なし	日次ダイジェストを取得し、優先順位付きのトリアージリストを作成します
respond-to-pr	prUrl	PR のコメントとコンテキストを取得し、返信の下書き作成に役立てます
find-issues	maxResults?	実現可能性スコアの高い順に課題を検索します
extract-learnings	repo、corpus、existingGuidelines?	生の PR コメント一式から、リポジトリごとに永続的なガイダンスを抽出します（#867）

プログラムからの使用

サーバーはライブラリとしてインポートして使用することもできます。

import { createServer } from '@oss-autopilot/mcp';

const server = createServer();
// Connect to your own transport

詳細情報

Claude Code プラグイン、CLI の使用方法、ダッシュボード、コントリビューションガイドなど、完全なドキュメントについてはメインリポジトリの READMEを参照してください。

ライセンス

MIT