{
  "markdown": "# GitHub MCP Server\n\n[![npm version](https://img.shields.io/npm/v/@bountyclaw/mcp-github-server.svg)](https://www.npmjs.com/package/@bountyclaw/mcp-github-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nA Model Context Protocol (MCP) server for GitHub operations. This server enables AI assistants to interact with GitHub repositories through a standardized interface.\n\n## Features\n\n- 🔍 **List & View Pull Requests** - Browse PRs with filtering options\n- 📋 **List & View Issues** - Access issues with labels, assignees, and comments\n- 📊 **Repository Info** - Get repository statistics and metadata\n- 🔎 **Code Search** - Search code across GitHub repositories\n\n## Installation\n\n```bash\nnpm install -g @bountyclaw/mcp-github-server\n```\n\n## Configuration\n\nSet your GitHub token as an environment variable:\n\n```bash\nexport GITHUB_TOKEN=your_github_token_here\n```\n\nOr pass it when creating the client programmatically.\n\n## Usage with Claude Code\n\nAdd to your Claude Code MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"github\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@bountyclaw/mcp-github-server\"],\n      \"env\": {\n        \"GITHUB_TOKEN\": \"your_github_token_here\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\n### 1. `github_pr_list`\n\nList pull requests for a repository.\n\n**Input:**\n- `owner` (string, required): Repository owner\n- `repo` (string, required): Repository name\n- `state` (enum, optional): Filter by state (`open`, `closed`, `all`)\n- `head` (string, optional): Filter by head branch\n- `base` (string, optional): Filter by base branch\n- `sort` (enum, optional): Sort field\n- `direction` (enum, optional): Sort direction\n- `per_page` (number, optional): Results per page (max 100)\n- `page` (number, optional): Page number\n\n### 2. `github_pr_view`\n\nView details of a specific pull request.\n\n**Input:**\n- `owner` (string, required): Repository owner\n- `repo` (string, required): Repository name\n- `pull_number` (number, required): PR number\n- `include_diff` (boolean, optional): Include diff content\n\n### 3. `github_issue_list`\n\nList issues for a repository.\n\n**Input:**\n- `owner` (string, required): Repository owner\n- `repo` (string, required): Repository name\n- `state` (enum, optional): Filter by state\n- `labels` (string, optional): Comma-separated label names\n- `assignee` (string, optional): Filter by assignee\n- `creator` (string, optional): Filter by creator\n- `sort` (enum, optional): Sort field\n- `direction` (enum, optional): Sort direction\n- `per_page` (number, optional): Results per page\n- `page` (number, optional): Page number\n\n### 4. `github_issue_view`\n\nView details of a specific issue.\n\n**Input:**\n- `owner` (string, required): Repository owner\n- `repo` (string, required): Repository name\n- `issue_number` (number, required): Issue number\n- `include_comments` (boolean, optional): Include comments\n\n### 5. `github_repo_info`\n\nGet repository information and statistics.\n\n**Input:**\n- `owner` (string, required): Repository owner\n- `repo` (string, required): Repository name\n\n### 6. `github_search_code`\n\nSearch code across GitHub.\n\n**Input:**\n- `query` (string, required): Search query (GitHub code search syntax)\n- `sort` (enum, optional): Sort field (`indexed`, `best-match`)\n- `order` (enum, optional): Sort order\n- `per_page` (number, optional): Results per page\n- `page` (number, optional): Page number\n\n## Example Queries\n\n```\n\"List open PRs in facebook/react\"\n\"Show me issue #123 in microsoft/vscode\"\n\"Get info about the kubernetes/kubernetes repo\"\n\"Search for 'useEffect' in TypeScript files\"\n```\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run tests\nnpm test\n\n# Run tests with coverage\nnpm run test:coverage\n\n# Lint\nnpm run lint\n\n# Format\nnpm run format\n```\n\n## Testing\n\nThe project includes comprehensive unit tests with 90%+ coverage:\n\n- GitHub API client tests\n- Tool handler tests for all 6 tools\n- Error handling tests\n- Input validation tests\n\n```bash\nnpm test\n```\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n---\n\nBuilt with 🦞 by BountyClaw\n",
  "bytes": 4219,
  "sha": "e99141e2f6cc01b966f72943279c971febfb4dcb3dd3a0a95a4fc38e6d761f4a",
  "repo_slug": "davidweb3-ctrl/mcp-github-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_davidweb3_ctrl_github_9b68c943/readme"
}