Ccx Claude Context Exchange

🚀 CCX - オープンソースMCPフレームワーク

Claude Codeが標準化されたサーバーを介して外部のAIツールを呼び出せる、コンパクトで本番環境向けのMCPフレームワークです。

🚀 クイックスタート

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キーを編集します

✨ 主な機能

• Claude Codeと外部AIのCLIをつなぐMCPサーバーを公開します。
• リクエスト/レスポンスフローに対して、クリーンで予測可能なメッセージインターフェイスを提供します。
• 最小限の設定で迅速なローカルセットアップを可能にします。

📦 インストール

上記の「クイックスタート」の手順に従ってインストールしてください。

💻 使用例

基本的な使用法

メール通知

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

コントリビューション

イシューとプルリクエストを歓迎します！