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許可證。

貢獻

歡迎提交問題和拉取請求！