How loidodev/github-mcp-server works
Project type and purpose
• This is a standalone backend microservice (“GitHub MCP Server”) built in Node.js/TypeScript.
• It implements the Model Context Protocol to expose “tools” that wrap GitHub API operations (list_user_repos, get_repo, create_repo, create_commit, push, pull).
File structure
• Top-level:
• package.json / tsconfig.json / build scripts
• src/ (all TypeScript source code)
• src/index.ts
• Application entrypoint (loads env, starts server)
• src/server.ts
• HTTP server setup, route or RPC dispatch
• src/tools/handlers.ts
• Implements each MCP “tool” by calling GitHub API
• src/tools/schemas.ts
• JSON schemas for validating tool parameters
• src/types.ts
• Shared TypeScript types (requests, responses, GitHub models)
• src/utils.ts
• HTTP client wrapper, auth, error handling
README
• Confirms it’s a service requiring GITHUB_TOKEN, exposes endpoints via MCP Inspector or npm start.
• No internal database—interacts directly with GitHub’s REST API.
• Provides a list of tools and parameters.