codehost-remote

codehost-remote

codehost-remote では、リポジトリ、ブランチ、ファイル、検索、イシュー、プルリクエストといった、使い慣れた GitHub のツール群をローカルの REST クライアントなしで利用できます。すべての呼び出しは、JSON-RPC の tools/call として、GitHub がホストするリモート MCP エンドポイント https://api.githubcopilot.com/mcp/ に転送されます。プレーンな JSON でもストリーミング SSE レスポンスでも、ホスト側からの応答がそのまま返されます。

そのため、軽量な選択肢となります。ローカルで GitHub API のバージョン管理を追う必要がなく、ホストサービスが処理を担います。その代わり、ホストされているエンドポイントの可用性と動作に依存します。

ここでは、14 個のツールからなるコアサブセットのみを公開しています。ホストエンドポイントは実際には、より大規模で動的なツールセット（40 個以上のツール）を提供しています。このパッケージは、意図的にリポジトリ／イシュー／プルリクエストのコアに固定しており、ホスト側の全ツール群を提供するとは一切謳っていません。

GITHUB_PERSONAL_ACCESS_TOKEN を設定してください。これは Bearer トークンとして送信されます。 GITHUB_REMOTE_MCP_URL でエンドポイントを上書きできます（テストに便利です）。

インストール

npx @reneturcios/codehost-remote get_issue '{"owner":"octocat","repo":"hello-world","issue_number":1}'
docker run -i -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/cloudcorprecords/codehost-remote

CLI

各ツールは、1 つの JSON 引数オブジェクトを受け取るサブコマンドです。

codehost-remote search_repositories '{"query":"mcp language:typescript"}'
codehost-remote create_issue '{"owner":"me","repo":"proj","title":"Bug: startup crash"}'
codehost-remote --version

終了コード：0 は成功、1 はエラー、2 は使用方法のエラーです。

MCP サーバー

npx -y @reneturcios/codehost-remote mcp

{
  "mcpServers": {
    "codehost-remote": {
      "command": "npx",
      "args": ["-y", "@reneturcios/codehost-remote", "mcp"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token" }
    }
  }
}

ツール

create_repository、fork_repository、create_branch、 get_file_contents、create_or_update_file、push_files、 search_repositories、search_code、list_issues、get_issue、 create_issue、add_issue_comment、list_pull_requests、 create_pull_request。

トークンが設定されていない場合は、GITHUB_PERSONAL_ACCESS_TOKEN を示すツールエラーが報告されます。

開発

npm install
npm run build
npm test

テストはすべて、プレーンな JSON と SSE の上流レスポンスボディを含む fake-fetch フィクスチャで実行されます。ネットワークは使用しません。

ライセンス

MIT — LICENSE を参照してください。