GitHub Activity MCP Server
🚀 GitHub Activity MCP Server
FastMCP と PyGithub で構築された MCP(Model Context Protocol)サーバーで、AI アシスタントを GitHub に接続し、リポジトリの検索、Issue や PR の管理、コントリビューションの分析などを行うことができます。
MCP とは? Model Context Protocol は、AI アシスタントが統一されたインターフェースを通じて外部データやツールに接続できるようにするオープンスタンダードです。「AI 向けの USB-C」と考えてください。
✨ 機能
このサーバーは 13 個のツール、3 個のリソースプロバイダー、3 個のプロンプトテンプレートを備え、MCP の 3 つのプリミティブすべてをカバーしています。
🔧 ツール(モデル制御)
AI が自律的に実行できるアクション:
ツール | 説明 |
| クエリ、言語、スター数で GitHub リポジトリを検索する |
| リポジトリの詳細情報(スター数、フォーク数、トピックなど)を取得する |
| リポジトリ内の任意のファイルを読み取る |
| フィルター付きで最近のコミットを一覧表示する |
| 状態、ラベル、担当者のフィルターで Issue を一覧表示する |
| Issue の詳細とコメントを取得する |
| 新しい Issue を作成する |
| Issue にコメントを追加する |
| 状態/ブランチのフィルターで PR を一覧表示する |
| PR の詳細とマージ状態を取得する |
| PR のコード変更を表示する |
| ユーザーの公開プロフィールを取得する |
| ユーザーのリポジトリを一覧表示する |
📦 リソース(アプリケーション制御)
AI が読み取れるコンテキストデータ:
リソース URI | 説明 |
| リポジトリの README(マークダウン) |
| ファイルツリーの全一覧 |
| パーセンテージ付きの言語別内訳 |
💬 プロンプト(ユーザー起動)
あらかじめ用意されたワークフローテンプレート:
プロンプト | 説明 |
| 総合的なリポジトリ分析 |
| ベストプラクティスに沿ったコードレビュー |
| オープンな Issue の分類と優先順位付け |
Related MCP server: GitHub MCP Server
🏗️ アーキテクチャ
graph LR
A[AI Assistant] <-->|MCP Protocol| B[GitHub MCP Server]
B <-->|REST API| C[GitHub API]
subgraph "MCP Server (FastMCP)"
B --> D[Tools]
B --> E[Resources]
B --> F[Prompts]
end
subgraph "Tools"
D --> D1[Repos]
D --> D2[Issues]
D --> D3[Pull Requests]
D --> D4[Users]
end🚀 クイックスタート
前提条件
Python ≥ 3.10
GitHub パーソナルアクセストークン(任意。ただし、レート制限を上げるために推奨)
インストール
# Clone the repository
git clone https://github.com/YOUR_USERNAME/github-mcp-server.git
cd github-mcp-server
# Install dependencies
pip install fastmcp PyGithubGitHub トークンの設定(任意)
repo スコープと read:user スコープを持つ パーソナルアクセストークン を作成します:
# Linux/macOS
export GITHUB_TOKEN=ghp_your_token_here
# Windows (PowerShell)
$env:GITHUB_TOKEN = "ghp_your_token_here"注: トークンがない場合、API リクエストは 1 時間あたり 60 回に制限されます。トークンがあれば 1 時間あたり 5,000 回利用できます。
サーバーの起動
# Run directly
fastmcp run src/server.py
# Or with Python
python -m src.serverFastMCP Dev Mode でテストする
fastmcp dev src/server.py⚙️ 設定
Claude Desktop
Claude Desktop の設定ファイルに追加します(macOS では ~/Library/Application Support/Claude/claude_desktop_config.json、Windows では %APPDATA%\Claude\claude_desktop_config.json):
{
"mcpServers": {
"github": {
"command": "fastmcp",
"args": ["run", "src/server.py"],
"cwd": "/absolute/path/to/github-mcp-server",
"env": {
"GITHUB_TOKEN": "ghp_your_token_here"
}
}
}
}Cursor
Cursor の MCP 設定(プロジェクト内またはグローバル設定の .cursor/mcp.json)に追加します:
{
"mcpServers": {
"github": {
"command": "fastmcp",
"args": ["run", "src/server.py"],
"cwd": "/absolute/path/to/github-mcp-server",
"env": {
"GITHUB_TOKEN": "ghp_your_token_here"
}
}
}
}VS Code(GitHub Copilot)
VS Code の設定(.vscode/settings.json)に追加します:
{
"mcp": {
"servers": {
"github": {
"command": "fastmcp",
"args": ["run", "src/server.py"],
"cwd": "/absolute/path/to/github-mcp-server",
"env": {
"GITHUB_TOKEN": "ghp_your_token_here"
}
}
}
}
}📁 プロジェクト構成
github-mcp-server/
├── src/
│ ├── __init__.py
│ ├── server.py # FastMCP server instance & entry point
│ ├── github_client.py # PyGithub client wrapper & error handling
│ ├── resources.py # Resource providers (README, tree, languages)
│ ├── prompts.py # Prompt templates (analyze, review, triage)
│ └── tools/
│ ├── __init__.py
│ ├── repos.py # Repository tools (search, get, file contents, commits)
│ ├── issues.py # Issue tools (list, get, create, comment)
│ ├── pulls.py # Pull request tools (list, get, diff)
│ └── users.py # User tools (profile, repos)
├── pyproject.toml
├── README.md
├── LICENSE
└── .gitignore🛠️ 技術スタック
技術 | 用途 |
高レベルな MCP サーバーフレームワーク | |
GitHub REST API クライアント | |
AI ツール統合のためのオープンスタンダード |
🤝 コントリビューション
コントリビューションを歓迎します。手順は以下のとおりです:
リポジトリをフォークします
フィーチャーブランチを作成します(
git checkout -b feature/amazing-feature)変更をコミットします(
git commit -m 'Add amazing feature')ブランチにプッシュします(
git push origin feature/amazing-feature)プルリクエストを開きます
📄 ライセンス
このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルを参照してください。
Maintenance
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
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to analyze GitHub repositories, including fetching repository details, searching, and retrieving README content.4522ISC
- FlicenseNot gradedqualityBmaintenanceEnables AI assistants to perform GitHub operations such as creating repositories, issues, pull requests, and more through natural language.
- FlicenseBqualityDmaintenanceEnables AI assistants to inspect local Git repositories and interact with the GitHub API for reading commits, diffs, files, issues, comments, pull requests, and project boards.10121
- FlicenseCqualityBmaintenanceEnables AI assistants to interact with GitHub repositories via the REST API, supporting repository listing, detail retrieval, and issue management.2
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.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/pranjal-sen-2004/github-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server