Ccx Claude Context Exchange

🚀 CCX - 开源MCP框架

CCX是一个紧凑的、面向生产的MCP框架，它允许Claude Code通过标准化服务器调用外部AI工具。

🚀 快速开始

1. 安装依赖

cd mcp-servers
npm install @modelcontextprotocol/sdk nodemailer

2. 安装CLI工具

# Codex CLI
npm install -g @openai/codex

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

3. 配置MCP服务器

将以下内容添加到你的Claude Code MCP配置中：

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. 设置配置

# 创建配置目录
mkdir -p ~/.claude

# 电子邮件配置
cp config-examples/email-config.json.example ~/.claude/email-config.json
# 使用你的电子邮件凭证进行编辑

# Gemini配置
mkdir -p ~/.gemini
cp config-examples/gemini.env.example ~/.gemini/.env
# 使用你的API密钥进行编辑

✨ 主要特性

• 提供MCP服务器，将Claude Code与外部AI命令行工具（CLI）连接起来。
• 为请求/响应流程提供简洁、可预测的消息接口。
• 只需最少的配置，即可快速完成本地设置。

📦 安装指南

依赖安装

cd mcp-servers
npm install @modelcontextprotocol/sdk nodemailer

CLI工具安装

# Codex CLI
npm install -g @openai/codex

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

服务器配置

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

配置设置

# 创建配置目录
mkdir -p ~/.claude

# 电子邮件配置
cp config-examples/email-config.json.example ~/.claude/email-config.json
# 使用你的电子邮件凭证进行编辑

# Gemini配置
mkdir -p ~/.gemini
cp config-examples/gemini.env.example ~/.gemini/.env
# 使用你的API密钥进行编辑

💻 使用示例

基础用法

电子邮件通知

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

Codex CLI

// 开始新会话
codex({ prompt: "Analyze this code...", new_session: true })

// 继续对话
codex({ prompt: "Now refactor it..." })

// 检查状态
codex_status()

// 重置会话
codex_reset()

Gemini CLI

// 开始新会话
gemini({ prompt: "Help me with...", new_session: true })

// 继续对话
gemini({ prompt: "What about..." })

// 检查状态
gemini_status()

// 重置会话
gemini_reset()

📚 详细文档

适用对象

• 使用Claude Code并希望连接外部AI功能的团队。
• 构建具有可预测输入/输出契约的MCP集成的工程师。
• 相较于托管API调用，更喜欢本地CLI工具的开发者。

设计原则

• 清晰的MCP边界。
• 最少的活动部件。
• 与Claude Code工作流程高度兼容。

目录结构

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

要求

• Node.js 18+
• Claude Code
• Codex CLI（可选）
• Gemini CLI（可选）

📄 许可证

本项目采用MIT许可证。

贡献

欢迎提交问题和拉取请求！