Skip to main content
Glama
deenesjakoruzh
rajeevpvt304-ops

GitHub Tools MCP Server

by rajeevpvt304-ops
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

GitHub Tools MCP Server

本物の Model Context Protocol サーバーで、GitHub REST API に対して読み取り専用のツールを公開します。1分以内で Claude Desktop や Claude Code にインストールでき、さらに、同じツールロジックを通常のチャットUIで試せる独立したWebデモも付属しています。

ライブデモ: https://mcp-demo-phi.vercel.app/demo

ステータス: これが何であり、何でないか

稼働中かつデプロイ済み。 全5つのツールを実際のGitHubデータで検証し、3つのテストスイートで42件の自動チェックが通り、本番URLでアプリ全体が稼働していることを確認済みです。ここまでのすべての判断とバグを正直に記録した継続的な記録は DESIGN_LOG.md を参照してください。

WebデモはMCPトランスポートではありません。 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 に追加する: %APPDATA%\Claude\claude_desktop_config.json（Windows）または ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）を編集し、claude_desktop_config.example.json の内容をマージします（実際の GITHUB_TOKEN と server.py の絶対パスを記入してください）。その後 Claude Desktop を再起動します。Claude Code に追加する: claude mcp add を実行するか、お使いのプロジェクトの .mcp.json を同じように編集します。

手動の対話型開発ワークフロー: 完全なクライアントなしでサーバーを手動で調べられるように、SDK にはインスペクターが同梱されています — npx @modelcontextprotocol/inspector python3 server.py。

Webデモをローカルで実行する

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

設計ログ

明白でないすべての決定に加えて、古くなっている可能性のあるドキュメントから推定するのではなく、実際にインストールされたパッケージに対して検証したSDK APIサーフェスも、DESIGN_LOG.md に記載しています。

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • GitHub MCP Server

    shibdad
    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.
    538 npm
    -

  • Repo Recap

    AbhiShrek07
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables Claude to query GitHub repositories in plain English, fetching recent activity, release notes, issue triage, and health summaries via the GitHub API.
    -