MCP Feather Code

🚀 Feather Code MCP Server

A comprehensive GitHub integration for Claude Desktop using the Model Context Protocol (MCP). Access all GitHub features directly from Claude with 15 powerful tools.

🚀 Quick Start

Feather Code MCP Server offers seamless integration with Claude Desktop, enabling direct access to GitHub features. You can start using it right away following the installation and usage steps below.

✨ Features

• 🚀 15 GitHub Tools: Complete GitHub API coverage.
• 🔍 Auto-detection: Automatically detects repository from git.
• 🔐 Flexible Auth: Supports PAT, GitHub App, and file-based tokens.
• 📦 Zero Config: Works out of the box in any git repository.
• ✅ MCP Compliant: Built with official MCP SDK.

📦 Installation

Quick Install (Recommended)

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

Manual Installation

1. Clone the repository:

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

2. Install dependencies:

   pip install -r requirements.txt
   

3. Set up authentication:

   export GITHUB_PAT=your_github_personal_access_token
   

💻 Usage Examples

Basic Usage

With Claude Desktop

Add to your Claude Desktop configuration:

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

Standalone

Run from any git repository:

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

Advanced Usage

You can utilize the various tools provided by Feather Code MCP Server for different GitHub operations. For example, creating an issue or searching for code within a repository.

📚 Documentation

Tools Available

Repository Management

• get_repository_info: Get comprehensive repository details.
• get_repository_languages: Get language breakdown.
• get_repository_topics: Get repository topics/tags.

Issues

• list_issues: List and filter repository issues.
• create_issue: Create new issues with labels.
• update_issue: Update existing issues.
• get_issue: Get detailed issue information.
• add_issue_comment: Add comments to issues.

Pull Requests

• get_pull_requests: List and filter pull requests.
• create_pull_request: Create new pull requests.
• get_pull_request: Get detailed PR information.

Code & Repository

• list_branches: List repository branches.
• get_commits: Get commit history with filters.
• get_file_content: Read file contents from repository.
• search_code: Search code within repository.

Authentication

Personal Access Token (Recommended)

1. Create a token at https://github.com/settings/tokens/new.
2. Select scopes: repo, read:org (for private repos).
3. Set the token:

   export GITHUB_PAT=ghp_your_token_here
   

Token File

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

GitHub App (Advanced)

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

Configuration

All configuration is done through environment variables:

Examples

Create an issue from Claude

User: Create a new issue titled "Bug: Login not working" with the bug label

Claude: I'll create that issue for you.
[Uses create_issue tool]

Created issue #123: "Bug: Login not working"

Search for code

User: Find all files that contain "authentication"

Claude: I'll search for files containing "authentication".
[Uses search_code tool]

Found 5 files containing "authentication":
- src/auth/login.py
- src/auth/middleware.py
...

Development

Running Tests

python3 test_comprehensive.py
python3 validate_production_ready.py

Building from Source

pip install -e .

Troubleshooting

"Repository not detected"

• Ensure you're in a git repository with a GitHub remote.
• Or set GITHUB_OWNER and GITHUB_REPO environment variables.

"Authentication failed"

• Check your GitHub token has the required scopes.
• Ensure the token is not expired.
• Try using a PAT instead of GitHub App auth.

"Tool not found"

• Update to the latest version.
• Check Claude Desktop has reloaded the MCP configuration.

📄 License

This project is under the MIT License. See the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create a feature branch.
3. Make your changes.
4. Submit a pull request.

🛠️ Support

• 📖 Documentation
• 🐛 Report Issues
• 💬 Discussions