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 文件。