Skip to main content
Glama
rajeevpvt304-ops

GitHub Tools MCP Server

GitHub Tools MCP Server

실제 Model Context Protocol 서버로, GitHub REST API에 대한 읽기 전용 도구를 노출한다. 1분 안에 Claude Desktop 또는 Claude Code에 설치할 수 있다. 또는 좀 같은 도구 로직을 일반 채팅 UI에서 실행하는 별도의 웹 데모도 포함한다.

라이브 데모: https://mcp-demo-phi.vercel.app/demo

상태: 이 프로젝트가 무엇이고 무엇이 아닌지

작동 중이며 배포됨. 5개 도구 전체가 실제 GitHub 데이터로 검증되었고, 3개의 테스트 스위트에서 42개의 자동 검사를 통과했으며, 전체 앱이 실제 프로덕션 URL에서 실행 중임을 확인했다. 그동안의 모든 결정과 버그에 대한 솔직하고 꾸준히 갱신된 기록은 DESIGN_LOG.md를 참조하라.

웹 데모는 MCP 전송(transport)이 아니다. MCP 프로토콜을 사용하는 것이 아니라, 동일한 tools.py 함수를 Python으로 직접 호출하는 단순한 FastAPI다. 정확히 구분하는 것이 실질적으로 유용한 차이이다. 실제 원격 MCP 전송을 여기서 시도하지 않은 이유는 DESIGN_LOG.md 섹션 3을 참조하라.

Related MCP server: GitHub MCP Connector

아키텍처

                    ┌─────────────────────┐
                    │      tools.py        │  <- 5 pure functions, no
                    │  (GitHub REST calls   │     MCP-specific code
                    │   via github_client)   │
                    └──────────┬───────────┘
                               │
              ┌────────────────┴────────────────┐
              │                                  │
    ┌─────────▼─────────┐            ┌───────────▼──────────┐
    │     server.py       │            │     api/index.py       │
    │  MCPServer, stdio    │            │  FastAPI, POST /chat    │
    │  transport            │            │  real Claude tool-      │
    │  -> Claude Desktop/    │            │  calling loop over       │
    │     Claude Code        │            │  the same tools           │
    └─────────────────────┘            └────────────────────────┘
     THE MCP SERVER                      A PLAIN HTTP DEMO OF
     (the real deliverable)              THE SAME TOOL LOGIC

설치

cp .env.example .env   # GITHUB_TOKEN (both halves), ANTHROPIC_API_KEY (web demo only)
pip install -r requirements.txt

MCP 서버를 로컬에서 실행

python3 server.py

Claude Desktop에 추가: Windows는 %APPDATA%\Claude\claude_desktop_config.json, macOS는 ~/Library/Application Support/Claude/claude_desktop_config.json을 편집하고, claude_desktop_config.example.json의 내용을 병합한 다음(실제 GITHUB_TOKENserver.py의 절대 경로를 입력), Claude Desktop을 다시 시작한다. Claude Code에 추가: claude mcp add를 실행하거나 프로젝트의 .mcp.json을 같은 방식으로 편집한다.

수동 대화형 개발 워크플로: SDK에는 전체 클라이언트 없이 서버를 직접 시험해 볼 수 있는 인스펙터가 포함되어 있다 — npx @modelcontextprotocol/inspector python3 server.py.

웹 데모를 로컬에서 실행

export $(cat .env | xargs)
uvicorn api.index:app --reload --port 8020

설계 기록

자명하지 않은 모든 결정과, 오래된 문서에서 추측한 내용이 아니라 실제 설치된 패키지를 기준으로 검증한 SDK API 표면에 대한 내용은 DESIGN_LOG.md에 있다.

F
license - not found
Not graded
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    Not graded
    quality
    Not graded
    maintenance
    Connects Claude Desktop to GitHub repositories, enabling users to perform git operations and GitHub API interactions through natural conversation.
    452
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables Claude to query GitHub repositories in plain English, fetching recent activity, release notes, issue triage, and health summaries via the GitHub API.

View all related MCP servers

Related MCP Connectors

  • Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.

  • Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analy…

  • Screens public GitHub repos and PRs to generate risk maps, findings, and merge-readiness signals.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/rajeevpvt304-ops/github-tools-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server