Skip to main content
Glama

Feather Code MCP Server

by neovasky
MIT License
1
  • Linux
  • Apple

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.

Features

  • 🚀 15 GitHub Tools - Complete GitHub API coverage
  • 🔍 Auto-detection - Automatically detects repository from git
  • 🔐 Flexible Auth - 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

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

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

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

  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:

VariableDescriptionDefault
GITHUB_OWNERRepository ownerAuto-detected from git
GITHUB_REPORepository nameAuto-detected from git
GITHUB_PATPersonal access token-
GITHUB_PAT_FILEPath to token file-
GITHUB_APP_IDGitHub App ID-
GITHUB_INSTALLATION_IDApp installation ID-
GITHUB_PRIVATE_KEY_PATHApp private key path-
GITHUB_API_URLGitHub API URLhttps://api.github.com

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

MIT License - see LICENSE file for details.

Contributing

Contributions are welcome! Please:

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

Support

-
security - not tested
A
license - permissive license
-
quality - not tested

A GitHub integration for Claude Desktop that provides access to GitHub features directly from Claude, offering 15 powerful tools for repository management, issues, pull requests, and code operations.

Related MCP Servers

  • -
    security
    F
    license
    -
    quality
    An integration server that provides Claude Desktop access to Gmail, enabling users to view recent emails and search their Gmail inbox using natural language commands.
    Last updated -
    6
    Python
  • -
    security
    -
    license
    -
    quality
    An MCP server that allows Claude and other MCP-compatible LLMs to interact with the GitHub API, supporting features like creating issues, getting repository information, listing issues, and searching repositories.
    Last updated -
    TypeScript
  • -
    security
    F
    license
    -
    quality
    A Multi-Claude Program for interacting with GitHub APIs through Claude Desktop, allowing users to search repositories, manage issues, pull requests, repository settings, workflows, and collaborators.
    Last updated -
    1
    Python
    • Linux
    • Apple
  • -
    security
    A
    license
    -
    quality
    Connects Claude Desktop to GitHub repositories, enabling users to perform git operations and GitHub API interactions through natural conversation.
    Last updated -
    JavaScript
    MIT License
    • Apple

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/neovasky/mcp-feather-code'

If you have feedback or need assistance with the MCP directory API, please join our Discord server