GitHub MCP CLI with Ollama

Ollama を使ったターミナルベースのプロジェクトで、Model Context Protocol (MCP) とローカル LLM を使用して GitHub データを照会・要約します。

概要

このプロジェクトは、以下の2つのコンポーネントに分かれています。

1. MCP サーバー (server.py)：fastmcp で構築されており、GitHub リポジトリの詳細、最近の issue、最近のコミットを取得するためのツールを提供します。

2. CLI クライアント (client.py)：rich と LangChain を使用した対話型ターミナルインターフェースで、ローカルの Ollama モデルと通信して MCP ツールと対話します。

Related MCP server: GitHub MCP Server

セットアップ

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

   pip install -r requirements.txt

2. GitHub アクセスを設定します: レート制限を増やし、プライベートリポジトリにアクセスするには、GitHub Personal Access Token (PAT) を環境変数としてエクスポートします（または .env ファイルに入れます）:

   export GITHUB_TOKEN="your_personal_access_token_here"

3. Ollama を起動します: ローカルで Ollama がツール対応モデル（llama3.2 など）で実行されていることを確認します:

   ollama run llama3.2

4. クライアントを実行します:

   python client.py

開発

現在、server.py と client.py はどちらも完全に動作します。クライアントは MultiServerMCPClient と LangChain の React Agent を使用して、ツールにシームレスに接続し、質問を Ollama にルーティングします。

MCP サーバーが公開するツール:

• get_repo(owner, repo): リポジトリの基本情報を取得します。

• list_issues(owner, repo, state, limit): 最近の issue を取得します。

• list_commits(owner, repo, limit): 最近のコミットを取得します。