@kadreio/mcp-coding-agents

A transport-agnostic MCP (Model Context Protocol) server with Claude Code, Gemini, and Codex agent integrations. Supports both STDIO and HTTP transports for flexible AI model context management.

Features

• 🚀 Transport-agnostic architecture - Clean separation between business logic and transport layers

• 🔄 Multiple transport modes - STDIO for direct process communication, HTTP with SSE for network access

• 🤖 Multiple AI agents - Claude Code, Gemini, and Codex integrations

• 📦 Built-in tools - BMI calculator, timestamp generator, command execution, and more

• 🔧 Extensible design - Easy to add new tools, prompts, and transports

• 💬 Real-time streaming - Support for notifications and SSE in HTTP mode

Installation

Native Dependencies

This package uses better-sqlite3 for session persistence, which requires compilation of native code. On most systems, prebuilt binaries are available and installation is automatic. If you encounter issues:

macOS/Linux: Ensure you have build tools installed:

Windows: Install windows-build-tools:

Quick Start

Using npx (no installation required)

After global installation

Transport Modes

STDIO Mode

Best for editor integrations and direct process communication:

• Communicates via stdin/stdout using JSON-RPC

• No network overhead

• Ideal for local development tools

HTTP Mode

Best for network access and web integrations:

• RESTful API with SSE support for streaming

• Session management for stateful interactions

• CORS support (configurable)

• Health check endpoint at /health

Available Tools

Core Tools

• calculate_bmi - Calculate Body Mass Index

• get_timestamp - Get current timestamp

• execute_command - Execute shell commands with timeout support

• stream_sse_timestamps - Generate streaming timestamps (HTTP mode)

AI Agent Tools

• claude_code_query - Query Claude Code with streaming responses

• gemini_query - Execute Gemini CLI commands

• codex_query - Execute Codex with JSONL streaming

Environment Variables

Development

Architecture

The server uses a clean, transport-agnostic architecture:

• CoreMCPServer: Contains all business logic, tool handlers, and agent integrations

• Transport Layer: Thin adapters for different communication protocols

• Unified CLI: Single entry point with transport selection

API Endpoints (HTTP Mode)

• POST /mcp - Main MCP endpoint for JSON-RPC requests

• GET /mcp - SSE endpoint for streaming notifications

• GET /health - Health check endpoint

• GET / - Server information and capabilities

HTTPS Support

The server supports HTTPS for secure communication:

Quick Start (Auto-Generated Certificate)

This will automatically generate a self-signed certificate on the fly. Perfect for development!

Using Your Own Certificates

Using Custom Certificates

HTTPS Options

• --https - Enable HTTPS mode

• --cert <path> - Path to SSL certificate file

• --key <path> - Path to SSL private key file

• --ca <path> - Path to SSL CA certificate file (optional)

MCP Client Configuration

For STDIO mode

For HTTP mode

Contributing

See CLAUDE.md for development guidelines and architecture details.

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Development Setup

Releasing

Releases are automated via GitHub Actions when you push a version tag:

See RELEASING.md for detailed release instructions.