Ccx Claude Context Exchange

🚀 CCX - Open Source MCP Framework

A compact, production - oriented MCP framework enabling Claude Code to call external AI tools via standardized 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

✨ Features

• 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.

📦 Installation

The installation process mainly involves installing dependencies, CLI tools, and configuring MCP servers. Please refer to the "Quick Start" section for detailed steps.

💻 Usage Examples

Basic Usage

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()

📚 Documentation

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!