CCX-开源MCP框架
一个紧凑的、面向生产的MCP框架,允许Claude Code通过标准化服务器调用外部AI工具。
它的作用
- 暴露连接Claude Code和外部AI CLI的MCP服务器
- 为请求/响应流提供干净、可预测的消息接口
- 以最少的配置实现快速的本地设置
包含的服务器
| 服务器 | 描述 |
|---|---|
email-notify.mjs | 用于发送电子邮件通知的MCP服务器 |
codex-mcp.mjs | 调用Codex CLI的MCP服务器 |
gemini-mcp.mjs | 调用Gemini CLI的MCP服务器 |
快速开始
1.安装依赖项
cd mcp-servers
npm install @modelcontextprotocol/sdk nodemailer2.安装CLI工具
# Codex CLI
npm install -g @openai/codex
# Gemini CLI
npm install -g @google/gemini-cli3.配置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.mjs4.设置配置
# 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使用示例
电子邮件通知
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()这是给谁的
- 使用Claude Code并希望连接外部AI功能的团队
- 工程师利用可预测的I/O合同构建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+
- 克劳德代码
- Codex CLI(可选)
- Gemini CLI(可选)
许可证
麻省理工学院
贡献
欢迎发布问题和PR!
