GitHub MCP CLI with Ollama

一个基于终端的项目，使用模型上下文协议（MCP）和本地大语言模型（通过 Ollama）来查询和汇总 GitHub 数据。

概述

本项目分为两个组件：

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 个人访问令牌（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)：获取最近的提交。