MCP工具箱

Install dependencies

pm.install_dependencies() # from requirements.txt or pyproject.toml pm.install_dependencies("requirements-dev.txt") # from specific file

Installation

1. Clone the repository:

git clone https://github.com/gianlucamazza/mcp_python_toolbox.git
cd mcp_python_toolbox

2. Create and activate a virtual environment: ```bash python -m venv .venv source .venv/bin/activate # Linux/Mac

Usage

Programmatic Usage

from mcp_python_toolbox import PythonToolboxServer

server = PythonToolboxServer(workspace_root="/path/to/your/project")
server.setup()
server.run()

Core Module Examples

#### File Operations ```python from mcp_python_toolbox.core import FileOperations

file_ops = FileOperations(workspace_root="/path/to/project")

Setting Up with Claude Desktop

Claude Desktop can automatically launch and manage the MCP Python Toolbox server. Here's how to configure it:

1. Install and set up the MCP Python Toolbox as described above
2. Add a configuration entry for the Python Toolbox in Claude Desktop's MCP tools configuration:

"python-toolbox": {
  "command": "/Users/username/path/to/mcp_python_toolbox/.venv/bin/python",
  "args": [
    "-m",
    "mcp_python_toolbox",
    "--workspace",
    "/Users/username/path/to/workspace"
  ],
  "env": {
    "PYTHONPATH": "/Users/username/path/to/mcp_python_toolbox/src",
    "PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin",
    "VIRTUAL_ENV": "/Users/username/path/to/mcp_python_toolbox/.venv",
    "PYTHONHOME": ""
  }
}

1. Customize the paths to match your environment
2. Claude Desktop will automatically start the MCP server when needed
3. Claude will now have access to Python development tools through the MCP interface

Create virtual environment

pm.create_virtual_environment()

Running as a CLI Tool

The simplest way to start the server is using the CLI:

```bash

Update packages

pm.update_package("requests") # to latest pm.update_package("flask", version="2.0.0") # to specific version

#### Code Execution

executor = CodeExecutor(workspace_root="/path/to/project")

code = ''' def greet(name): return f"Hello, {name}!"

print(greet("World")) '''

result = executor.execute_code(code) print(f"Output: {result['stdout']}") print(f"Errors: {result['stderr']}") print(f"Exit code: {result['exit_code']}") ```