Cline Github MCP

🚀 GitHub PR ロボットサーバー（GitHub PR-MCP）

GitHub PR ロボットサーバー（GitHub PR-MCP）は、GitHub のプルリクエスト関連の操作を自動化するためのサーバーです。このサーバーを使用することで、GitHub 上のプロジェクト管理を効率化することができます。

🚀 クイックスタート

このセクションでは、GitHub PR ロボットサーバーをすぐに使い始めるための手順を説明します。

📦 インストール

高速インストール

npm install github-pr-mcp

プロジェクトのビルド

1. リポジトリをクローンします。

   git clone https://github.com/your-username/github-pr-mcp.git
   cd github-pr-mcp
   

2. 依存関係をインストールします。

   npm install
   

3. 開発サーバーを起動します。

   npm run dev
   

💻 使用例

基本的な使用法

設定ファイルの初期化

github-pr-mcp init

サーバーの起動

npm start

一般的な設定

環境変数

以下の環境変数を設定することで、サーバーの動作をカスタマイズできます。

• GITHUB_TOKEN: 必須。認証に使用する GitHub の個人アクセストークンです。
• PORT: オプション。デフォルトは 3000。サーバーが動作するポートを指定します。

高度な使用法

GitHub PR 機能の統合

const server = new GithubPRServer();
server.createPullRequest({
  owner: 'your-org',
  repo: 'your-repo',
  title: '新機能実装',
  head: 'feature-branch',
  base: 'main',
  // その他のオプションパラメータ...
});

📚 ドキュメント

開発

ディレクトリ構造

src/
├── index.ts          # メインの MCP サーバー実装
├── api/             # API ルートとミドルウェア
├── config/          # 設定ファイル
└── types/           # TypeScript の型定義

新機能の追加

1. src/types/index.ts で型を定義します。
2. メインサーバーの実装を更新し、src/index.ts に新機能を追加します。
3. GitHubServer クラスに新しいツールハンドラーを追加します。
4. ドキュメントを更新します。

開発環境の設定

前提条件

• Node.js 18+
• npm または yarn
• Git
• 個人アクセストークンを持つ GitHub アカウント

ローカル開発

1. 依存関係をインストールします。

   npm install
   

2. 開発サーバーを起動します。

   npm run dev
   

3. テストを実行します。

   npm test
   

テスト

• 単体テスト: npm run test:unit
• 統合テスト: npm run test:integration
• テストカバレッジ: npm run test:coverage

トラブルシューティング

一般的な問題

1. 認証エラー

   • トークンが必要な権限を持っていることを確認してください。
   • トークンが環境に正しく設定されていることを確認してください。
   • トークンの有効期限を確認してください。

2. ビルド問題

   • ビルドディレクトリをクリアします: rm -rf build/
   • 依存関係を再インストールします: npm install

3. サーバー起動失敗

   • ポートが使用されていないことを確認してください。
   • 環境変数が正しく設定されていることを確認してください。

貢献ガイド

コードの提出

CONTRIBUTING.md ファイルのガイドに従って貢献してください。

プルリクエストの作成

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更をコミットし、メインブランチにプルリクエストを作成します。

📄 ライセンス

このプロジェクトは LICENSE の下でオープンソースとして公開されています。

連絡先

質問や提案がある場合は、your.email@example.com までご連絡ください。