MCP Starter

🚀 Notion統合付きGitHub PRアナライザー

GitHubのプルリクエストの変更内容を取得し、Notionで分析サマリーを作成するモデルコンテキストプロトコル（MCP）サーバーです。

チュートリアル: DataCampのMCPチュートリアル のステップバイステップガイドに従ってください。

🚀 クイックスタート

このアプリケーションは、GitHubのプルリクエストの変更内容を取得し、Notionで分析サマリーを作成するためのMCPサーバーです。以下の手順で始めることができます。

✨ 主な機能

• 🔍 GitHubのプルリクエストの詳細情報を取得します。具体的には以下の内容です。
  • ファイルの変更（追加、削除、修正）
  • プルリクエストのメタデータ（タイトル、説明、作者、タイムスタンプ）
  • 各変更ファイルの差分パッチ
• 📝 プルリクエストの分析内容を含むNotionページを作成します。
• 🔌 MCPサーバーとの統合により、ツールをシームレスに使用できます。

📦 インストール

前提条件

• Python 3.8以上
• GitHubの個人アクセストークン
• NotionのAPIキーとページID

インストール手順

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

git clone <repository-url>
cd mcp-starter

2. Pythonの仮想環境を作成してアクティブ化します。

# 仮想環境の作成
python -m venv venv

# 仮想環境のアクティブ化
# macOS/Linuxの場合:
source venv/bin/activate

# Windowsの場合:
# venv\Scripts\activate

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

pip install -r requirements.txt

4. プロジェクトのルートに .env ファイルを作成し、認証情報を記述します。

GITHUB_TOKEN=your_github_token_here
NOTION_API_KEY=your_notion_api_key_here
NOTION_PAGE_ID=your_notion_page_id_here

認証情報の取得方法

GitHubトークン:

1. GitHubの設定 → 開発者設定 → 個人アクセストークンに移動します。
2. repo スコープを持つ新しいトークンを生成します。
3. トークンを .env ファイルにコピーします。

Notion APIキー:

1. https://www.notion.so/my-integrations にアクセスします。
2. 新しい統合を作成し、内部統合トークンをコピーします。
3. Notionページを統合と共有します。

NotionページID:

1. ブラウザでNotionページを開きます。
2. URLからページID（最後の / の後で ? の前の部分）をコピーします。

💻 使用例

MCPサーバーの起動

まず、仮想環境がアクティブ化されていることを確認します。

# macOS/Linuxの場合:
source venv/bin/activate

# Windowsの場合:
# venv\Scripts\activate

その後、サーバーを起動します。

python pr_analyzer.py

サーバーは2つのMCPツールを公開しています。

1. fetch_pr

GitHubからプルリクエストの情報を取得します。 パラメータ:

• repo_owner (str): リポジトリの所有者のユーザー名
• repo_name (str): リポジトリ名
• pr_number (int): プルリクエスト番号

戻り値:

• プルリクエストのメタデータと詳細なファイルの変更内容

2. create_notion_page

分析内容を含むNotionページを作成します。 パラメータ:

• title (str): ページのタイトル
• content (str): ページの内容

戻り値:

• 成功またはエラーメッセージ

直接使用（開発/テスト）

github_integration.py モジュールを直接使用することもできます。

from github_integration import fetch_pr_changes

# プルリクエストの変更内容を取得
pr_data = fetch_pr_changes('owner', 'repo', 123)
print(pr_data)

📚 ドキュメント

プロジェクト構造

mcp-starter/
├── github_integration.py  # GitHub APIの統合
├── pr_analyzer.py         # MCPサーバーの実装
├── requirements.txt       # プロジェクトの依存関係
├── .env                   # 環境変数（git管理外）
└── README.md             # このファイル

依存関係

主な依存関係は以下の通りです。

• mcp - モデルコンテキストプロトコルサーバー
• requests - GitHub APIの呼び出し
• notion-client - Notion APIの統合
• python-dotenv - 環境変数の管理
• pydantic - データの検証
• httpx - 非同期HTTPクライアント

完全なリストは requirements.txt を参照してください。

エラーハンドリング

アプリケーションには包括的なエラーハンドリングが含まれています。

• APIリクエストの失敗は捕捉され、ログに記録されます。
• 欠落している認証情報は適切なエラーメッセージをトリガーします。
• デバッグ用にスタックトレースがstderrに出力されます。

開発

貢献または修正を行うには以下の手順を行ってください。

1. .env ファイルが適切に設定されていることを確認します。
2. MCPサーバーを実行する前に、直接使用方法で変更をテストします。
3. デバッグ情報を得るためにstderrの出力を確認します。

セキュリティに関する注意事項

⚠️ 重要: .env ファイルには機密情報が含まれているため、決してバージョン管理システムにコミットしないでください。

.gitignore に以下の内容を追加してください。

.env
__pycache__/
*.pyc

📄 ライセンス

MITライセンス

Copyright (c) 2024

このソフトウェアおよび関連するドキュメントファイル（「ソフトウェア」）のコピーを取得するすべての人に対して、無料で、制限なくこのソフトウェアを取り扱う許可がここに与えられます。これには、限定するものではありませんが、使用、コピー、修正、統合、公開、配布、サブライセンス、および/またはソフトウェアのコピーを販売する権利が含まれます。また、このソフトウェアが提供されるすべての人に対しても同様のことを行うことを許可しますが、以下の条件に従う必要があります。

上記の著作権表示およびこの許諾表示は、ソフトウェアのすべてのコピーまたは実質的な部分に含まれる必要があります。

このソフトウェアは、「現状のまま」提供され、明示または黙示を問わず、商品性、特定の目的への適合性、および非侵害の保証を含むすべての種類の保証がないことが明示されます。いかなる場合も、著者または著作権者は、契約、不法行為、またはその他の方法によるクレーム、損害、またはその他の責任について、ソフトウェアまたはソフトウェアの使用またはその他の取り扱いに関連して、いかなる責任も負わないものとします。

このプロジェクトは、Unlicenseの下で公共ドメインに公開されています。

商用または非商用を問わず、あらゆる目的でこのソフトウェアを自由に使用、変更、配布、利用することができます。詳細については、 Unlicense を参照してください。

作者

Kiet Tran (Leo Loves Coding)

サポート

問題や質問がある場合は、リポジトリにイシューを作成してください。