Claude MCP Server Collection

Claude MCP サーバーコレクション

このリポジトリには、Claude のデスクトップアプリの機能を拡張するために設計された Model Context Protocol (MCP) サーバーのコレクションが含まれています。各サーバーは、Claude がさまざまな方法でコンピューターとやり取りできるようにする特定の機能を提供します。

最新の追加: DuckDB 統合! 🚀

効率的な大規模データ分析のための新しい DuckDB FastAPI サーバー:

クエリと結果の例

クエリ 1: 分析

クエリ 2: 集計結果

DuckDB サーバーの機能

• Claude Desktop で複数の CSV ファイル (>1GB) を直接分析
• DuckDB による超高速な SQL クエリ
• メモリ効率の高いデータ処理
• コネクションプーリングとキャッシュ
• 未使用のコネクションの自動クリーンアップ

概要

このプロジェクトは、いくつかの MCP サーバーで構成されています:

1. スクリーンキャプチャサーバー - スクリーンショットをキャプチャして処理します
2. コンピューター制御サーバー - キーボードとマウスの自動化を可能にします
3. FastAPI 統合サーバー - データ処理と API エンドポイントを処理します
4. Curl サーバー - HTTP リクエスト機能を提供します
5. DuckDB サーバー - 大規模データ分析を可能にします

前提条件

• Python 3.8 以上
• Node.js および npm (ファイルシステムサーバー用)
• Claude Desktop アプリケーション
• Git

インストール

1. リポジトリをクローンします:

git clone https://github.com/syedazharmbnr1/ClaudeMCPServer.git
cd ClaudeMCPServer

2. 仮想環境を作成してアクティブ化します:

python3 -m venv .env
source .env/bin/activate  # On Windows: .env\Scripts\activate

3. 依存関係をインストールします:

pip install -r requirements.txt

サーバーコンポーネント

1. DuckDB サーバー

Claude が大きな CSV ファイルを効率的に分析できるようにします。

セットアップと使用方法:

cd fastapi/duckdb
python main.py

機能:

• 複数の CSV ファイルを同時に処理
• 1GB を超えるファイルを処理
• DuckDB による高速な SQL クエリ
• メモリ効率の高い処理
• コネクションプーリング

2. スクリーンキャプチャサーバー

Claude が画面のスクリーンショットをキャプチャして処理できるようにします。

セットアップと使用方法:

python mcp_screen_server.py

機能:

• リアルタイムのスクリーンキャプチャ
• 動的な画像圧縮
• 最適なファイルサイズのための WebP 形式サポート
• カスタマイズ可能な保存先

3. コンピューター制御サーバー

Claude がマウスとキーボードの操作を制御できるようにします。

セットアップと使用方法:

python ComputerUse/mcp_computer_server.py

機能:

• マウスの移動とクリック
• キーボードショートカットとテキスト入力
• 画面位置の追跡
• クリップボード操作

4. FastAPI 統合サーバー

FastAPI サーバーは、データ処理と統合のための堅牢な API インターフェースを提供します。

セットアップと設定:

1. FastAPI ディレクトリに移動します:

cd fastapi

2. 環境変数を設定します:

export PYTHONPATH=/path/to/mcp-server-py
export PORT=8000

3. サーバーを起動します:

python main.py

5. Curl サーバー

Claude に HTTP リクエスト機能を提供します。

セットアップ:

cd Curl_Server
./start_server.sh  # For the basic server
./start_mcp_server.sh  # For the MCP integration

Claude Desktop 統合

設定

1. claude_desktop_config.json を Claude Desktop アプリの設定ディレクトリにコピーします

2. 設定内のパスを自分のシステムに合わせて更新します:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "<your-paths-here>"
      ]
    },
    "duckdb": {
      "command": "/path/to/python",
      "args": [
        "/path/to/fastapi/duckdb/main.py"
      ],
      "cwd": "/path/to/fastapi/duckdb",
      "env": {
        "PYTHONPATH": "/path/to/mcp-server-py",
        "PORT": "8010"
      }
    }
  }
}

テスト

各コンポーネントには独自のテストスイートがあります:

# Test screen capture
python test_screen_server.py

# Test computer control
python ComputerUse/test_computer_control.py

# Test integration
python ComputerUse/test_client.py

トラブルシューティング

よくある問題

1. Python パスの問題:

• PYTHONPATH が正しく設定されていることを確認してください
• 仮想環境がアクティブ化されていることを確認してください

2. 権限エラー:

• スクリプトファイルが実行可能であることを確認してください:

chmod +x *.py
chmod +x Curl_Server/*.sh

3. ポートの競合:

• スクリーンサーバー: デフォルトポート 8767
• FastAPI サーバー: デフォルトポート 8000
• DuckDB サーバー: デフォルトポート 8010
• 統合サーバー: デフォルトポート 8768

ログ

• 詳細なエラーメッセージについては debug.log を確認してください
• 各サーバーコンポーネントは独自のログファイルに書き込みます

セキュリティに関する注意事項

1. GitHub 統合:

• GitHub トークンは安全に保管してください
• トークンをリポジトリにコミットしないでください

2. ファイルシステムへのアクセス:

• ファイルシステムのパスを慎重に設定してください
• 必要なディレクトリへのアクセスのみに制限してください

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. プルリクエストを送信します

ライセンス

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