github-mcp-server
Provides GitHub API tools (repo info, open PRs, latest release) via FastMCP, easily run with uvx.
README
github-mcp-server
GitHub API를 조회하는 MCP 서버. FastMCP 기반으로 구현되었으며 uvx로 바로 실행할 수 있다.
이 저장소의 FastMCP 구현 패턴은 .claude/skills/fastmcp-server.md에 정리되어 있다.
도구
| 도구 | 설명 |
|---|---|
get_repo_info |
저장소 기본 정보 (이름, 설명, 스타, 포크, 이슈 수) |
list_open_prs |
열린 Pull Request 목록 (최대 20개) |
get_latest_release |
최신 릴리즈 정보 (태그, 이름, 본문, 날짜) |
설치 및 실행
uvx (권장)
GITHUB_TOKEN=your_token uvx github-mcp-server
로컬 개발
uv sync
GITHUB_TOKEN=your_token uv run python server.py
환경변수
| 변수 | 필수 | 설명 |
|---|---|---|
GITHUB_TOKEN |
권장 | GitHub Personal Access Token. 없으면 공개 저장소만 조회 가능하며 API 요청 제한이 낮아짐 |
.env 파일에 작성하면 자동으로 로드된다:
GITHUB_TOKEN=ghp_xxxxxxxxxxxx
MCP 클라이언트 연결
팀원용 (GitHub 저장소에서 직접 설치)
.mcp.json.team에 정의되어 있다. 사용하려면 프로젝트 루트에 복사하고 GITHUB_TOKEN을 설정한다:
cp .mcp.json.team .mcp.json
export GITHUB_TOKEN=your_token
{
"mcpServers": {
"github-tools": {
"type": "stdio",
"command": "uvx",
"args": [
"--from",
"git+https://github.com/myorg/github-mcp-server",
"github-mcp-server"
],
"env": {
"GITHUB_TOKEN": "${GITHUB_TOKEN}"
}
}
}
}
로컬 개발용 (이 저장소를 직접 수정하는 경우)
프로젝트 루트 .mcp.json에 아래처럼 로컬 소스를 직접 실행하도록 설정한다. .mcp.json은 Claude Code가 프로젝트 루트에서만 자동으로 인식하므로 다른 경로(.claude/ 등)에 두면 로드되지 않는다.
{
"mcpServers": {
"github-tools": {
"type": "stdio",
"command": "uv",
"args": ["run", "python", "server.py"],
"cwd": "/absolute/path/to/github-mcp-server"
}
}
}
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
Neon Database
MCP server for interacting with Neon Management API and databases
E2B
Using MCP to run code via e2b.
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.