CCX - Open Source MCP Framework

A compact, production-oriented MCP framework that lets Claude Code call external AI tools through standardized servers.

What It Does

• Exposes MCP servers that bridge Claude Code with external AI CLIs
• Provides a clean, predictable message interface for request/response flows
• Enables quick local setup with minimal configuration

Included Servers

Quick Start

1. Install Dependencies

cd mcp-servers
npm install @modelcontextprotocol/sdk nodemailer

2. Install CLI Tools

# Codex CLI
npm install -g @openai/codex

# Gemini CLI
npm install -g @google/gemini-cli

3. Configure MCP Servers

Add to your Claude Code MCP configuration:

claude mcp add email-notify node /path/to/mcp-servers/email-notify.mjs
claude mcp add codex-mcp node /path/to/mcp-servers/codex-mcp.mjs
claude mcp add gemini-mcp node /path/to/mcp-servers/gemini-mcp.mjs

4. Set Up Configurations

# Create config directory
mkdir -p ~/.claude

# Email configuration
cp config-examples/email-config.json.example ~/.claude/email-config.json
# Edit with your email credentials

# Gemini configuration
mkdir -p ~/.gemini
cp config-examples/gemini.env.example ~/.gemini/.env
# Edit with your API key

Usage Examples

Email Notification

send_email({
  subject: "Task Complete",
  content: "Your task has been completed successfully!"
})

Codex CLI

// Start a new session
codex({ prompt: "Analyze this code...", new_session: true })

// Continue conversation
codex({ prompt: "Now refactor it..." })

// Check status
codex_status()

// Reset session
codex_reset()

Gemini CLI

// Start a new session
gemini({ prompt: "Help me with...", new_session: true })

// Continue conversation
gemini({ prompt: "What about..." })

// Check status
gemini_status()

// Reset session
gemini_reset()

Who Is This For

• Teams using Claude Code who want to connect external AI capabilities
• Engineers building MCP integrations with predictable I/O contracts
• Developers who prefer local CLI tools over hosted API calls

Design Principles

• Clear MCP boundaries
• Minimal moving parts
• Strong compatibility with Claude Code workflows

Directory Structure

ccx-opensource/
├── README.md
├── README_CN.md
├── mcp-servers/
│   ├── email-notify.mjs
│   ├── codex-mcp.mjs
│   └── gemini-mcp.mjs
└── config-examples/
    ├── email-config.json.example
    └── gemini.env.example

Requirements

• Node.js 18+
• Claude Code
• Codex CLI (optional)
• Gemini CLI (optional)

License

MIT

Contributing

Issues and PRs are welcome!