GitHub MCP CLI with Ollama

터미널 기반 프로젝트로, Model Context Protocol(MCP)과 로컬 LLM(Ollama를 통해)을 사용하여 GitHub 데이터를 조회하고 요약합니다.

개요

이 프로젝트는 두 가지 구성 요소로 나뉩니다:

1. MCP 서버(server.py): fastmcp로 구축되었으며, GitHub 저장소 세부 정보, 최근 이슈, 최근 커밋을 가져오는 도구를 제공합니다.

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): 최근 이슈를 가져옵니다.

• list_commits(owner, repo, limit): 최근 커밋을 가져옵니다.