Github Stars MCP Server

🚀 GitHub Stars MCP 服務器

這是一個高性能的模型上下文協議（MCP）服務器，用於 GitHub 星標分析和時間線跟蹤，能幫助用戶深入瞭解開發趨勢和技術採用模式。

🚀 快速開始

安裝

# 克隆倉庫
git clone https://github.com/your-org/github-stars-mcp-server.git
cd github-stars-mcp-server

# 使用 uv 安裝依賴
uv sync

# 激活虛擬環境
source .venv/bin/activate

配置

創建一個 .env 文件，並填入你的 GitHub 應用憑證：

GITHUB_APP_ID=your_app_id
GITHUB_APP_PRIVATE_KEY_PATH=path/to/private-key.pem
GITHUB_APP_INSTALLATION_ID=your_installation_id
REDIS_URL=redis://localhost:6379

使用

# 啟動 MCP 服務器
github-stars-mcp-server

✨ 主要特性

• GitHub 星標分析：檢索並分析用戶的星標倉庫。
• 時間線跟蹤：跟蹤隨時間變化的星標模式。
• 技術洞察：從星標倉庫中分析技術趨勢。
• 高性能：採用異步/等待模式和 Redis 緩存構建。
• GitHub 應用認證：使用 GitHub 應用進行安全認證。

📦 安裝指南

# 克隆倉庫
git clone https://github.com/your-org/github-stars-mcp-server.git
cd github-stars-mcp-server

# 使用 uv 安裝依賴
uv sync

# 激活虛擬環境
source .venv/bin/activate

💻 使用示例

基礎用法

# 啟動 MCP 服務器
github-stars-mcp-server

📚 詳細文檔

開發

# 安裝開發依賴
uv sync --dev

# 運行測試
pytest

# 運行代碼檢查
ruff check .

# 運行類型檢查
mypy src/

Docker

# 構建 Docker 鏡像
docker build -t github-stars-mcp-server .

# 運行容器
docker run -p 8000:8000 --env-file .env github-stars-mcp-server

貢獻代碼

1. 分叉倉庫
2. 創建功能分支
3. 進行更改
4. 添加測試
5. 運行測試套件
6. 提交拉取請求

🔧 技術細節

技術棧

架構

此服務器採用模塊化架構：

• src/github_stars_mcp_server/config.py：配置管理
• src/github_stars_mcp_server/models.py：Pydantic 數據模型
• src/github_stars_mcp_server/github_client.py：GitHub API 客戶端
• src/github_stars_mcp_server/server.py：MCP 服務器實現
• src/github_stars_mcp_server/tools/：MCP 工具實現

性能

• 全程使用異步/等待進行非阻塞操作。
• 使用 Redis 緩存頻繁訪問的數據。
• 使用 GraphQL 進行高效的 API 查詢。
• 使用連接池優化資源使用。

安全

• 使用 GitHub 應用認證進行安全的 API 訪問。
• 基於環境的配置。
• 使用 Pydantic 進行輸入驗證。
• 使用結構化日誌進行審計跟蹤。

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。