MCP Feather Code

🚀 Feather Code MCP 服务器

Feather Code MCP 服务器借助模型上下文协议（MCP），为 Claude Desktop 提供全面的 GitHub 集成。通过 15 个强大的工具，你可以直接在 Claude 中访问所有 GitHub 功能。

🚀 快速开始

Feather Code MCP 服务器能让你在 Claude Desktop 里无缝使用 GitHub 的各项功能。下面为你介绍安装和使用的基本步骤。

✨ 主要特性

• 🚀 15 个 GitHub 工具 - 全面覆盖 GitHub API 功能。
• 🔍 自动检测 - 可从 Git 自动检测仓库信息。
• 🔐 灵活认证 - 支持个人访问令牌（PAT）、GitHub 应用和基于文件的令牌。
• 📦 零配置 - 可在任何 Git 仓库中直接使用。
• ✅ 符合 MCP 标准 - 基于官方 MCP SDK 构建。

📦 安装指南

快速安装（推荐）

Linux/macOS：

curl -fsSL https://raw.githubusercontent.com/yourusername/feather-code/main/install.sh | bash

Windows：

Invoke-WebRequest -Uri https://raw.githubusercontent.com/yourusername/feather-code/main/install.bat -OutFile install.bat
.\install.bat

手动安装

1. 克隆仓库：

   git clone https://github.com/yourusername/feather-code.git
   cd feather-code
   

2. 安装依赖：

   pip install -r requirements.txt
   

3. 配置认证：

   export GITHUB_PAT=your_github_personal_access_token
   

💻 使用示例

与 Claude Desktop 集成

将以下内容添加到你的 Claude Desktop 配置中：

{
  "mcpServers": {
    "feather-code": {
      "command": "python3",
      "args": ["/path/to/feather-code/feather_code.py"]
    }
  }
}

独立使用

在任何 Git 仓库中运行：

cd /your/github/repo
python3 /path/to/feather_code.py

可用工具

仓库管理

• get_repository_info - 获取仓库的详细信息。
• get_repository_languages - 获取仓库的语言分布。
• get_repository_topics - 获取仓库的主题/标签。

问题管理

• list_issues - 列出并过滤仓库问题。
• create_issue - 创建带有标签的新问题。
• update_issue - 更新现有问题。
• get_issue - 获取问题的详细信息。
• add_issue_comment - 为问题添加评论。

拉取请求管理

• get_pull_requests - 列出并过滤拉取请求。
• create_pull_request - 创建新的拉取请求。
• get_pull_request - 获取拉取请求的详细信息。

代码与仓库

• list_branches - 列出仓库的分支。
• get_commits - 按条件获取提交历史。
• get_file_content - 读取仓库中的文件内容。
• search_code - 在仓库中搜索代码。

🔧 技术细节

认证方式

个人访问令牌（推荐）

1. 在 https://github.com/settings/tokens/new 创建令牌。
2. 选择作用域：repo，read:org（用于私有仓库）。
3. 设置令牌：

   export GITHUB_PAT=ghp_your_token_here
   

令牌文件

echo "ghp_your_token_here" > ~/.github_token
export GITHUB_PAT_FILE=~/.github_token

GitHub 应用（高级）

export GITHUB_APP_ID=123456
export GITHUB_INSTALLATION_ID=789012
export GITHUB_PRIVATE_KEY_PATH=/path/to/private-key.pem

配置参数

所有配置均通过环境变量完成：

使用示例

从 Claude 创建问题

用户：创建一个标题为 "Bug: Login not working" 的新问题，并添加 bug 标签

Claude：我将为你创建该问题。
[使用 create_issue 工具]

已创建问题 #123："Bug: Login not working"

搜索代码

用户：查找所有包含 "authentication" 的文件

Claude：我将搜索包含 "authentication" 的文件。
[使用 search_code 工具]

找到 5 个包含 "authentication" 的文件：
- src/auth/login.py
- src/auth/middleware.py
...

开发相关

运行测试

python3 test_comprehensive.py
python3 validate_production_ready.py

从源代码构建

pip install -e .

故障排除

"Repository not detected"

• 确保你处于具有 GitHub 远程仓库的 Git 仓库中。
• 或者设置 GITHUB_OWNER 和 GITHUB_REPO 环境变量。

"Authentication failed"

• 检查你的 GitHub 令牌是否具有所需的作用域。
• 确保令牌未过期。
• 尝试使用个人访问令牌（PAT）而非 GitHub 应用认证。

"Tool not found"

• 更新到最新版本。
• 检查 Claude Desktop 是否重新加载了 MCP 配置。

📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

🤝 贡献指南

欢迎贡献代码！请按照以下步骤操作：

1. 分叉仓库。
2. 创建功能分支。
3. 进行修改。
4. 提交拉取请求。

🛠️ 支持与反馈

• 📖 文档
• 🐛 报告问题
• 💬 讨论区