mcp-server-github

GitHub operations MCP server

Quick Start

cd mcp-server-github
npm install
kadi install
kadi run build
kadi run start

Note: The runtime entrypoint is dist/index.js (package.json start: "node dist/index.js"), so ensure you run the build step before starting.

Related MCP server: Git PR MCP Server

Configuration

agent.json

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 start

Notes:

• The build uses bun to compile TypeScript (src/index.ts) to dist/.

• The start script runs the compiled Node server (node dist/index.js).