mcp-server-github
GitHub operations MCP server
Quick Start
cd mcp-server-github
npm install
kadi install
kadi run build
kadi run startNote: The runtime entrypoint is dist/index.js (package.json start: "node dist/index.js"), so ensure you run the build step before starting.
Configuration
agent.json
| Field | Value | |-------|-------| | Name | mcp-server-github | | Version | 0.1.0 | | Start script | node dist/index.js | | Build (default) | from: node:20-alpine, cli: latest | | Build run steps | npm install -g bun; npm ci --include=dev; bun build ./src/index.ts --outdir ./dist --target node --external pino --external pino-pretty --external @octokit/rest; npm prune --omit=dev | | Build env | NODE_ENV=production |
Runtime / Environment notes
- Transport mode: The server checks MCP_TRANSPORT_TYPE (case-insensitive). If unset or set to "stdio", the server runs in STDIO mode and ANSI colors are disabled (NO_COLOR=1, FORCE_COLOR=0).
- Startup logs include:
- server name and version (config.mcpServerName / config.mcpServerVersion),
- selected transport (config.mcpTransportType),
- GitHub API host (config.githubHost or config.githubApiUrl),
- GitHub token presence (masked in logs, showing only the last 4 characters if set).
- On startup the application composes the dependency-injection container (composeContainer) and creates the MCP server instance (createMcpServerInstance).
- The selected transport is started via startTransport(server, createMcpServerInstance). For HTTP transport a factory (createMcpServerInstance) is provided so each session gets a fresh server instance.
- In STDIO mode, fatal startup errors are written directly to stderr; otherwise they are logged via the logger.
- The server installs handlers for SIGTERM and SIGINT to log shutdown and exit gracefully (process.exit(0)). Uncaught exceptions are logged (including stack) and the process exits with code 1.
- The server uses the compiled output in dist/ (built by the kadi build process defined above).
Development
npm install
kadi install
kadi run build
kadi run startNotes:
- The build uses bun to compile TypeScript (src/index.ts) to dist/.
- The start script runs the compiled Node server (node dist/index.js).
---
