GitHub MCP Server

{ "description": "Example JSON-RPC requests for manual testing", "instructions": "Send these requests via stdin to the MCP server", "examples": [ { "name": "List Tools", "request": { "jsonrpc": "2.0", "id": 1, "method": "tools/list" }, "command": "echo '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}' | node dist/mcp/server.js" }, { "name": "Get Authored PRs", "request": { "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "github.getAuthoredPRs", "arguments": { "username": "octocat", "from": "2024-01-01T00:00:00Z", "to": "2024-12-31T23:59:59Z" } } }, "command": "echo '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"github.getAuthoredPRs\",\"arguments\":{\"username\":\"octocat\",\"from\":\"2024-01-01T00:00:00Z\",\"to\":\"2024-12-31T23:59:59Z\"}}}' | node dist/mcp/server.js" }, { "name": "Get Authored PRs (with repo filter)", "request": { "jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": { "name": "github.getAuthoredPRs", "arguments": { "username": "octocat", "from": "2024-01-01T00:00:00Z", "to": "2024-12-31T23:59:59Z", "repos": ["github/docs"] } } } }, { "name": "Get PR Reviews", "request": { "jsonrpc": "2.0", "id": 4, "method": "tools/call", "params": { "name": "github.getPRReviews", "arguments": { "username": "octocat", "from": "2024-01-01T00:00:00Z", "to": "2024-12-31T23:59:59Z" } } } }, { "name": "Get Review Comments", "request": { "jsonrpc": "2.0", "id": 5, "method": "tools/call", "params": { "name": "github.getReviewComments", "arguments": { "username": "octocat", "from": "2024-01-01T00:00:00Z", "to": "2024-12-31T23:59:59Z" } } } }, { "name": "Get Comment Impact", "request": { "jsonrpc": "2.0", "id": 6, "method": "tools/call", "params": { "name": "github.getCommentImpact", "arguments": { "username": "octocat", "from": "2024-01-01T00:00:00Z", "to": "2024-12-31T23:59:59Z" } } } }, { "name": "Get User Comments", "request": { "jsonrpc": "2.0", "id": 8, "method": "tools/call", "params": { "name": "github.getUserComments", "arguments": { "username": "octocat", "repo": "github/docs", "from": "2024-01-01T00:00:00Z", "to": "2024-12-31T23:59:59Z" } } }, "command": "echo '{\"jsonrpc\":\"2.0\",\"id\":8,\"method\":\"tools/call\",\"params\":{\"name\":\"github.getUserComments\",\"arguments\":{\"username\":\"octocat\",\"repo\":\"github/docs\",\"from\":\"2024-01-01T00:00:00Z\",\"to\":\"2024-12-31T23:59:59Z\"}}}' | node dist/mcp/server.js", "note": "Fetches all comments (review and issue) by a user for a specific repository within a time range" }, { "name": "Get User Repository Statistics", "request": { "jsonrpc": "2.0", "id": 9, "method": "tools/call", "params": { "name": "github.getUserRepoStats", "arguments": { "username": "octocat", "repo": "github/docs", "from": "2024-01-01T00:00:00Z", "to": "2024-12-31T23:59:59Z" } } }, "command": "echo '{\"jsonrpc\":\"2.0\",\"id\":9,\"method\":\"tools/call\",\"params\":{\"name\":\"github.getUserRepoStats\",\"arguments\":{\"username\":\"octocat\",\"repo\":\"github/docs\",\"from\":\"2024-01-01T00:00:00Z\",\"to\":\"2024-12-31T23:59:59Z\"}}}' | node dist/mcp/server.js", "note": "Get comprehensive repository statistics: PRs, comments, reviews, and code changes for a user within a time range" } ], "testing_tips": [ "Set GITHUB_TOKEN environment variable before testing", "Use 'jq' to pretty-print JSON responses: ... | jq '.'", "The server communicates via stdio using JSON-RPC 2.0 protocol", "Each request must include Content-Length header (handled automatically by test scripts)", "For interactive testing, use the test-server.ts script" ] }