mcp_server_for_claudes_toolbox

mcp_server_for_claudes_toolbox

作成者：Claude 3.7 Sonnet、Kyle Rose

バージョン：0.2.0

Claude の Toolbox ユーティリティプログラムを Model Context Protocol（MCP）経由で公開するサーバーアプリケーションです。これにより、Claude Code、Claude Desktop、Copilot など、さまざまなインターフェースを通じて Claude などの AI アシスタントから利用できます。

特長

• 関数を自由に登録して呼び出せます。tools/functions フォルダーに関数を追加し、その関数名をファイル名に付けるだけで、利用できるようになります。
• さまざまなタスクに対応する、単体で動作する一連のコマンドラインインターフェース（CLI）ツールを公開します。現在、次の CLI ツールを利用できます。
  • test_generator：JSON 仕様から unittest テストファイルを作成します。
  • documentation_generator：Python ソースコードから Markdown ドキュメントを生成します。
  • lint_a_python_codebase：空行、末尾の空白、新しい行など、Python ファイルによくある lint の問題を修正します。
  • run_tests_and_save_their_results：Python プロジェクトの単体テスト、型チェック、lint を実行し、結果を JSON ファイルと Markdown ファイルに保存します。
  • codebase_search：パターンマッチングを使用してコードを検索します。
• 各 CLI ツールはそれぞれ独立したプログラムであり、専用の仮想環境を使用するよう設定できます。ツールが呼び出されると、サーバーは適切な仮想環境を自動的に有効化します。
• configs.yaml ファイルでサーバー設定をカスタマイズできます。詳細度、ログレベル、ホスト、ポート、リロードのオプションなどを簡単に変更できます。
• WSL2、Linux／MacOS、Windows に対応しています。これにより、Windows 上で Posix 環境向けに書かれたツールを登録して実行したり、その逆を行ったりできます。使用するプラットフォームの MCP 設定ファイルに適切な設定コードを追加するだけです。

設定

サーバーは configs.yaml ファイルで設定できます。

verbose: True
log_level: 10
host: '0.0.0.0'
port: 8000
reload: True
load_from_paths_csv: True

要件

• WSL2、Linux。Windows のサポートは今後追加予定です。
• Python 3.12+
• mcp # MCP サーバー用
• aiofile # 非同期ファイル操作用
• anthropic # Anthropic の LLM API アクセス用
• coverage # テストカバレッジ用
• duckdb # クロスプラットフォームのデータベース操作用
• flask # Web フレームワーク用
• flake8 # lint 用
• httpx # 非同期 HTTP リクエスト用
• jinja2 # テンプレート用
• mcp # Claude ツールサーバー API 用
• multiformats # CID 作成用
• mypy # 型チェック用
• numpy # 数値演算用
• openai # OpenAI の LLM API アクセス用
• psutil # システムおよびプロセスのユーティリティ用
• pydantic # データ検証と設定管理用
• pytest # テスト用
• pyyaml # YAML 解析用
• tqdm # プログレスバー用

インストール

1. このリポジトリをクローンします。

git clone https://github.com/the-ride-never-ends/claudes_toolbox

2. インストールスクリプトを実行します。

Linux／MacOS の場合：

cd claudes_toolbox
bash ./install_server.sh

Windows の場合：

cd claudes_toolbox
cmd .\install_server.bat

3. 該当する設定コードをコピーして、使用する MCP 設定ファイルに貼り付けます。 Windows 版 Claude Desktop の場合、通常は C:\Users\<username>\AppData\Roaming\Claude\claude_desktop_config.json にあります。

WSL 上でホストするサーバー：

run_wsl.config

"claudes-toolbox": {
    "command": "wsl",
    "args": [
    "bash",
    "-c",
    "source ~/.bashrc && ~/claudes_toolbox/mcp_server_for_claudes_toolbox/start_claudes_toolbox_server.sh --called-with-wsl"
    ]
}

Linux／MacOS 上でホストするサーバー：

run_linux.config

"claudes-toolbox": {
  "command": "bash",
  "args": [
    "-c",
    "source ~/.bashrc || source ~/.bash_profile || source ~/.zshrc; ~/claudes_toolbox/start_server.sh"
  ]
}

Windows 上でホストするサーバー：

"claudes-toolbox": {
    "command": "cmd.exe",
    "args": [
        "/c",
        "C:\\path\\to\\start_server.bat"
    ]
}

4. 他のリポジトリを Git クローンし、claude_toolbox/tools/cli ディレクトリに配置します。

cd claudes_toolbox/tools
git clone https://github.com/the-ride-never-ends/documentation_generator
git clone https://github.com/the-ride-never-ends/test_generator
git clone https://github.com/the-ride-never-ends/run_tests_and_save_their_results
git clone https://github.com/the-ride-never-ends/lint_a_python_codebase
git clone https://github.com/the-ride-never-ends/codebase_search

ツールが呼び出されると、サーバーは適切な仮想環境を自動的に有効化します。

使用方法

Copilot、Claude Code、Claude Desktop などの統合アプリケーションは、MCP プロトコルを使用してサーバーを呼び出せます。指定されたコマンドが実行されると、サーバーが自動的に起動します。

サーバーは次のように動作します。

• コマンドラインへのサブプロセス呼び出しを通じてツールを実行します。
• 仮想環境を有効化するラッパー関数を使用します。
• MCP プロトコルを介して、各ツールを適切なパラメーターとともに公開します。

ディレクトリ構成

mcp_server_for_claudes_toolbox/
├── docs/               # Documentation files
├── tests/              # Test files and test cases
├── utils/              # Utility scripts
├── data/               # Data files used by the program (if any)
├── app.py              # MCP server application
├── configs.py          # Configurations singleton for the program
├── logger.py           # Logger singleton for the program
├── TODO.md             # Todo list 
├── CHANGELOG.md        # Changelog list
├── claude.md           # Instructions to Claude in Claude Code API
├── requirements.txt    # 3rd-party library requirements
├── install.sh          # Set-up venv and install requirements
├── start.sh            # Script to start the server
└── README.md           # This file

ライセンス

MIT