wd902/claude-mcp-server

Claude MCP Server

用途別 AI モデル使い分け対応の MCP サーバー - Kiro IDE 統合・AWS Bedrock 対応

🚀 3 つの AI モデルを用途別に使い分けて、最大 95%のコスト削減を実現

概要

AWS Bedrock の Amazon Nova + Claude の 3 つの AI モデルを用途に応じて使い分けられるシンプルな MCP サーバーです。

対応モデル

• chat_casual: Amazon Nova Micro（超低コスト）
• chat_professional: Claude Sonnet 4（バランス型）
• chat_expert: Claude Opus 4（最高性能）

特徴

• ✅ コスト効率: 用途に応じたモデル選択で大幅なコスト削減
• ✅ シンプル構成: chat 系 3 ツールのみの分かりやすい構成
• ✅ 高性能: 全モデルで 5 秒以内の応答を実現
• ✅ 実用性: 日常的に使える実用的なツール

インストール

1. 依存関係のインストール

pip install -r requirements.txt

2. 開発モードでのインストール

pip install -e .

3. 環境設定

.env.example を .env にコピーして設定を調整：

cp .env.example .env

Kiro IDE 統合

mcp.json 設定

{
  "mcpServers": {
    "claude-mcp-server": {
      "command": "python",
      "args": ["-m", "claude_opus_mcp"],
      "env": {
        "MCP_AWS_PROFILE": "sts",
        "MCP_AWS_REGION": "us-east-1",
        "MCP_USE_TEST_MODEL": "true"
      },
      "disabled": false,
      "autoApprove": ["chat_casual", "chat_professional", "chat_expert"],
      "disabledTools": []
    }
  }
}

使用方法

Kiro IDE での使用例

# 日常会話（Amazon Nova Micro - 超低コスト）
@claude-mcp-server chat_casual おはよう。今日は良い天気だね

# 技術相談（Claude Sonnet 4 - バランス型）
@claude-mcp-server chat_professional Pythonの非同期処理について教えて

# 高度な設計相談（Claude Opus 4 - 最高性能）
@claude-mcp-server chat_expert マイクロサービスアーキテクチャの設計指針を教えて

設定

環境変数

AWS 設定

1. AWS CLI の設定
2. Bedrock モデルアクセスの有効化
3. 適切な IAM 権限の設定

開発

テスト実行

# 全テスト実行
python tests/run_tests.py

# 単体テスト
pytest tests/test_config.py

# 統合テスト
pytest tests/test_integration.py

コード品質チェック

# フォーマット
black claude_opus_mcp/ tests/

# リント
ruff check claude_opus_mcp/ tests/

# 型チェック
mypy claude_opus_mcp/

アーキテクチャ

claude_opus_mcp/
├── __init__.py          # パッケージ初期化
├── __main__.py          # エントリーポイント
├── server.py            # MCP サーバー実装
├── config.py            # 設定管理
├── bedrock_client.py    # AWS Bedrock クライアント
├── tool_handlers.py     # ツールハンドラー実装
└── exceptions.py        # カスタム例外

コスト効率

実測値

• Amazon Nova Micro: 超低コスト（日常会話）
• Claude Sonnet 4: 中程度コスト（技術相談）
• Claude Opus 4: 高コスト（高度な設計）

従来比較

• Amazon Nova Micro: 従来の 1/400 のコスト
• Claude Sonnet 4: 従来の 1/4 のコスト
• 適切な使い分けで大幅なコスト削減を実現

トラブルシューティング

よくある問題

1. AWS 認証エラー

   • AWS プロファイルの設定を確認
   • IAM 権限の確認

2. モデルアクセスエラー

   • Bedrock コンソールでモデルアクセスを有効化
   • リージョンの確認

3. MCP サーバーが認識されない

   • mcp.json の構文確認
   • パッケージのインストール確認

🤝 貢献

プルリクエストやイシューの報告を歓迎します！

貢献方法

1. このリポジトリをフォーク
2. フィーチャーブランチを作成 (git checkout -b feature/amazing-feature)
3. 変更をコミット (git commit -m 'Add amazing feature')
4. ブランチにプッシュ (git push origin feature/amazing-feature)
5. プルリクエストを作成

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は ファイルを参照してください。

🔗 関連リンク

• AWS Bedrock - AWS の生成 AI サービス
• Model Context Protocol - MCP 公式サイト
• Kiro IDE - AI 統合開発環境

⭐ Star History

このプロジェクトが役に立った場合は、ぜひ Star をお願いします！