Initial commit
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
dinlo
+127
@@ -0,0 +1,127 @@
|
||||
# Byte-compiled / optimized / DLL files
|
||||
__pycache__/
|
||||
*.py[cod]
|
||||
*$py.class
|
||||
|
||||
# Virtual environments
|
||||
.venv/
|
||||
venv/
|
||||
ENV/
|
||||
env/
|
||||
|
||||
# Distribution / packaging
|
||||
.Python
|
||||
build/
|
||||
develop-eggs/
|
||||
dist/
|
||||
downloads/
|
||||
eggs/
|
||||
.eggs/
|
||||
lib/
|
||||
lib64/
|
||||
parts/
|
||||
sdist/
|
||||
var/
|
||||
wheels/
|
||||
*.egg-info/
|
||||
.installed.cfg
|
||||
*.egg
|
||||
|
||||
# PyInstaller
|
||||
*.manifest
|
||||
*.spec
|
||||
|
||||
# Installer logs
|
||||
pip-log.txt
|
||||
pip-delete-this-directory.txt
|
||||
|
||||
# Unit test / coverage reports
|
||||
htmlcov/
|
||||
.tox/
|
||||
.nox/
|
||||
.coverage
|
||||
.coverage.*
|
||||
.cache
|
||||
nosetests.xml
|
||||
coverage.xml
|
||||
*.cover
|
||||
*.py,cover
|
||||
.hypothesis/
|
||||
.pytest_cache/
|
||||
|
||||
# Translations
|
||||
*.mo
|
||||
*.pot
|
||||
|
||||
# Django stuff:
|
||||
*.log
|
||||
local_settings.py
|
||||
db.sqlite3
|
||||
db.sqlite3-journal
|
||||
|
||||
# Flask stuff:
|
||||
instance/
|
||||
.webassets-cache
|
||||
|
||||
# Scrapy stuff:
|
||||
.scrapy
|
||||
|
||||
# Sphinx documentation
|
||||
docs/_build/
|
||||
|
||||
# PyBuilder
|
||||
target/
|
||||
|
||||
# Jupyter Notebook
|
||||
.ipynb_checkpoints
|
||||
|
||||
# pyenv
|
||||
.python-version
|
||||
|
||||
# celery beat schedule file
|
||||
celerybeat-schedule
|
||||
|
||||
# SageMath parsed files
|
||||
*.sage.py
|
||||
|
||||
# Environments
|
||||
.env
|
||||
.venv
|
||||
.env.bak
|
||||
.env.local
|
||||
.env*.local
|
||||
|
||||
# Virtualenvwrapper
|
||||
virtualenvwrapper.sh
|
||||
|
||||
# AWS SAM
|
||||
.sam/
|
||||
|
||||
# mypy
|
||||
.mypy_cache/
|
||||
.dmypy.json
|
||||
dmypy.json
|
||||
|
||||
# Pyre type checker
|
||||
.pyre/
|
||||
|
||||
# Logs
|
||||
logs/
|
||||
*.log
|
||||
server.log
|
||||
|
||||
# IDE
|
||||
.idea/
|
||||
.vscode/
|
||||
*.swp
|
||||
*.swo
|
||||
*~
|
||||
|
||||
# OS files
|
||||
.DS_Store
|
||||
Thumbs.db
|
||||
desktop.ini
|
||||
|
||||
# MCP specific
|
||||
*.mcp-session
|
||||
.mcp/
|
||||
@@ -0,0 +1,20 @@
|
||||
# uv configuration for mcp-python-manager
|
||||
# This file is read by uv/uvx for project-specific settings
|
||||
|
||||
[project]
|
||||
# Use this project as the source for the package
|
||||
name = "mcp-python-manager"
|
||||
|
||||
[run]
|
||||
# Default command when running with uvx
|
||||
command = "mcp-python-manager"
|
||||
|
||||
[env]
|
||||
# Environment variables for uvx runs
|
||||
PYTHONUNBUFFERED = "1"
|
||||
UV_LINK_MODE = "copy"
|
||||
|
||||
[cache]
|
||||
# Cache settings for faster uvx runs
|
||||
no-cache = false
|
||||
offline = false
|
||||
+239
@@ -0,0 +1,239 @@
|
||||
# 🚀 Quick Start Guide
|
||||
|
||||
## ⚡ First Time Setup with uv (Recommended)
|
||||
|
||||
```cmd
|
||||
# 1. Install uv if not already installed
|
||||
winget install astral-sh.uv
|
||||
# or
|
||||
pip install uv
|
||||
|
||||
# 2. Navigate to project directory
|
||||
cd C:\Users\dimir\proects\mcp-python
|
||||
|
||||
# 3. Run directly with uvx - no setup needed!
|
||||
uvx --from . mcp-python-manager
|
||||
```
|
||||
|
||||
## 🐍 First Time Setup with pip (Traditional)
|
||||
|
||||
```cmd
|
||||
# 1. Navigate to project directory
|
||||
cd C:\Users\dimir\proects\mcp-python
|
||||
|
||||
# 2. Create virtual environment
|
||||
python -m venv .venv
|
||||
|
||||
# 3. Activate virtual environment
|
||||
.venv\Scripts\activate
|
||||
|
||||
# 4. Install dependencies
|
||||
pip install -r requirements.txt
|
||||
|
||||
# 5. (Optional) Install dev tools
|
||||
pip install -e ".[dev]"
|
||||
```
|
||||
|
||||
## Run the Server
|
||||
|
||||
### ⚡ With uvx (Recommended)
|
||||
|
||||
```cmd
|
||||
# Basic run (stdio transport - for MCP clients)
|
||||
uvx --from . mcp-python-manager
|
||||
|
||||
# With debug output
|
||||
uvx --from . mcp-python-manager --debug
|
||||
|
||||
# With custom workspace
|
||||
uvx --from . mcp-python-manager --workspace "C:\My\Projects"
|
||||
|
||||
# SSE transport (for HTTP clients)
|
||||
uvx --from . mcp-python-manager --transport sse --port 8000
|
||||
```
|
||||
|
||||
### 🐍 With Python (Traditional)
|
||||
|
||||
```cmd
|
||||
# Basic run (stdio transport - for MCP clients)
|
||||
python server.py
|
||||
|
||||
# With debug output
|
||||
python server.py --debug
|
||||
|
||||
# With custom workspace
|
||||
python server.py --workspace "C:\My\Projects"
|
||||
|
||||
# SSE transport (for HTTP clients)
|
||||
python server.py --transport sse --port 8000
|
||||
```
|
||||
|
||||
## Test the Server
|
||||
|
||||
```cmd
|
||||
# Run built-in tests
|
||||
python test_server.py
|
||||
|
||||
# Run with pytest (if installed)
|
||||
pytest tests/ -v
|
||||
```
|
||||
|
||||
## Connect from Claude Desktop
|
||||
|
||||
### ⚡ Using uvx (Recommended)
|
||||
|
||||
1. Edit your Claude Desktop config:
|
||||
- Location: `%APPDATA%\Claude\claude_desktop_config.json`
|
||||
|
||||
2. Add this configuration:
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"python-manager": {
|
||||
"command": "uvx",
|
||||
"args": [
|
||||
"--from",
|
||||
"C:/Users/dimir/proects/mcp-python",
|
||||
"mcp-python-manager",
|
||||
"--transport",
|
||||
"stdio"
|
||||
],
|
||||
"env": {
|
||||
"MCP_PYTHON_WORKSPACE": "C:/Users/dimir/projects",
|
||||
"UV_NO_CACHE": "0",
|
||||
"UV_LINK_MODE": "copy"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
3. Restart Claude Desktop
|
||||
|
||||
### 🐍 Using Python (Traditional)
|
||||
|
||||
1. Edit your Claude Desktop config:
|
||||
- Location: `%APPDATA%\Claude\claude_desktop_config.json`
|
||||
|
||||
2. Add this configuration:
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"python-manager": {
|
||||
"command": "python",
|
||||
"args": ["C:/Users/dimir/proects/mcp-python/server.py"],
|
||||
"env": {
|
||||
"MCP_PYTHON_WORKSPACE": "C:/Users/dimir/projects",
|
||||
"PYTHONUNBUFFERED": "1"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
3. Restart Claude Desktop
|
||||
|
||||
## Example Prompts for Claude
|
||||
|
||||
Once connected, you can ask Claude to:
|
||||
|
||||
```
|
||||
📁 Project Management:
|
||||
- "Show me the structure of my project at C:\projects\myapp"
|
||||
- "What Python files are in the src directory?"
|
||||
- "Read the first 50 lines of main.py"
|
||||
|
||||
🔧 Code Execution:
|
||||
- "Run the script at scripts/deploy.py with --dry-run argument"
|
||||
- "Execute pytest on the tests folder with coverage"
|
||||
- "Install the packages from requirements.txt"
|
||||
|
||||
🐛 Debugging:
|
||||
- "What Python processes are currently running?"
|
||||
- "Get debug info for main.py"
|
||||
- "Show me the Python environment details"
|
||||
|
||||
✨ Code Quality:
|
||||
- "Lint all Python files in src/ using flake8"
|
||||
- "Format the code in utils.py using black"
|
||||
- "Run pylint on the entire project"
|
||||
|
||||
📦 Dependencies:
|
||||
- "List all installed packages in my venv"
|
||||
- "Analyze dependencies in requirements.txt for issues"
|
||||
- "Create a new virtual environment for my project"
|
||||
```
|
||||
|
||||
## Common Commands Reference
|
||||
|
||||
### ⚡ With uvx
|
||||
|
||||
| Task | Command |
|
||||
|------|---------|
|
||||
| Start server | `uvx --from . mcp-python-manager` |
|
||||
| Start with debug | `uvx --from . mcp-python-manager --debug` |
|
||||
| Start with workspace | `uvx --from . mcp-python-manager --workspace "C:\Projects"` |
|
||||
| Install uv | `winget install astral-sh.uv` |
|
||||
| Update uv | `uv self update` |
|
||||
|
||||
### 🐍 With pip
|
||||
|
||||
| Task | Command |
|
||||
|------|---------|
|
||||
| Start server | `python server.py` |
|
||||
| Test server | `python test_server.py` |
|
||||
| Install deps | `pip install -r requirements.txt` |
|
||||
| Install dev deps | `pip install -e ".[dev]"` |
|
||||
| Run with debug | `python server.py --debug` |
|
||||
| Check Python version | `python --version` |
|
||||
| Activate venv | `.venv\Scripts\activate` |
|
||||
| Deactivate venv | `deactivate` |
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Server won't start
|
||||
```cmd
|
||||
# Check Python version
|
||||
python --version # Should be 3.10+
|
||||
|
||||
# Reinstall dependencies
|
||||
pip install --upgrade -r requirements.txt
|
||||
|
||||
# Check for port conflicts (SSE mode)
|
||||
netstat -ano | findstr :8000
|
||||
```
|
||||
|
||||
### Tools not working
|
||||
```cmd
|
||||
# Enable debug logging
|
||||
set MCP_PYTHON_DEBUG=true
|
||||
python server.py
|
||||
|
||||
# Check allowed commands in config.py
|
||||
# Add missing commands to config.allowed_commands
|
||||
```
|
||||
|
||||
### Permission errors
|
||||
```cmd
|
||||
# Run terminal as Administrator
|
||||
# Or adjust file/folder permissions
|
||||
# Check antivirus software blocking execution
|
||||
```
|
||||
|
||||
## Next Steps
|
||||
|
||||
1. ✅ Server installed and tested
|
||||
2. ⬜ Configure Claude Desktop / Cursor / VS Code
|
||||
3. ⬜ Customize `config.py` for your workflow
|
||||
4. ⬜ Add custom tools in `tools.py`
|
||||
5. ⬜ Set up CI/CD for your projects
|
||||
|
||||
## Need Help?
|
||||
|
||||
- Check `README.md` for full documentation
|
||||
- Run `python test_server.py` for diagnostics
|
||||
- Review logs in `server.log` (if configured)
|
||||
- Check allowed commands in `config.py`
|
||||
|
||||
---
|
||||
*Created for Windows 11 • Python 3.10+ • MCP Protocol*
|
||||
@@ -0,0 +1,546 @@
|
||||
# MCP Python Project Manager Server
|
||||
|
||||
A Model Context Protocol (MCP) server for managing and debugging Python projects on Windows 11.
|
||||
|
||||
## 🚀 Features
|
||||
|
||||
### Project Management
|
||||
- **Project Info**: Get comprehensive information about Python projects including structure, dependencies, and environment
|
||||
- **File Operations**: List, read, and analyze project files with filtering options
|
||||
- **Directory Tree**: Visualize project structure with configurable depth
|
||||
|
||||
### Execution & Debugging
|
||||
- **Run Scripts**: Execute Python scripts with custom arguments and environment variables
|
||||
- **Debug Info**: Get information about running Python processes and scripts
|
||||
- **Environment Details**: Inspect Python interpreter, packages, and sys.path
|
||||
|
||||
### Package Management
|
||||
- **Install Packages**: Install packages via pip with requirements file support
|
||||
- **List Packages**: View installed packages in JSON or text format
|
||||
- **Dependency Analysis**: Analyze requirements files and detect potential issues
|
||||
|
||||
### Code Quality
|
||||
- **Linting**: Run flake8, pylint, and black checks on your code
|
||||
- **Formatting**: Auto-format code using black or autopep8
|
||||
- **Testing**: Execute tests with pytest or unittest framework
|
||||
|
||||
### Environment Management
|
||||
- **Virtual Environments**: Create and manage Python virtual environments
|
||||
- **Environment Detection**: Auto-detect and use project venvs
|
||||
- **Python Version Support**: Configure specific Python versions
|
||||
|
||||
### File Watching
|
||||
- **Change Notifications**: Watch files for modifications (configurable patterns)
|
||||
- **Pattern Filtering**: Include/exclude files by glob patterns
|
||||
|
||||
## 📦 Installation
|
||||
|
||||
### Prerequisites
|
||||
|
||||
**Option A: Using uv (Recommended ⚡)**
|
||||
- [`uv`](https://github.com/astral-sh/uv) installed on Windows 11
|
||||
- Install uv: `winget install astral-sh.uv` or `pip install uv`
|
||||
|
||||
**Option B: Traditional Python**
|
||||
- Python 3.10+ installed on Windows 11
|
||||
- pip package manager
|
||||
|
||||
### Setup with uv (Recommended)
|
||||
|
||||
```cmd
|
||||
# 1. Navigate to project directory
|
||||
cd C:\Users\dimir\proects\mcp-python
|
||||
|
||||
# 2. Install and run directly with uvx (no venv needed!)
|
||||
uvx --from C:/Users/dimir/proects/mcp-python mcp-python-manager
|
||||
```
|
||||
|
||||
### Setup with pip (Traditional)
|
||||
|
||||
```cmd
|
||||
# 1. Clone or create project directory:
|
||||
cd C:\Users\dimir\proects
|
||||
mkdir mcp-python
|
||||
cd mcp-python
|
||||
|
||||
# 2. Create virtual environment:
|
||||
python -m venv .venv
|
||||
.venv\Scripts\activate
|
||||
|
||||
# 3. Install dependencies:
|
||||
pip install -r requirements.txt
|
||||
|
||||
# 4. Optional: Install development tools:
|
||||
pip install py-spy safety pip-audit
|
||||
```
|
||||
|
||||
## ⚙️ Configuration
|
||||
|
||||
### Environment Variables
|
||||
|
||||
| Variable | Description | Default |
|
||||
|----------|-------------|---------|
|
||||
| `MCP_PYTHON_WORKSPACE` | Root directory for projects | `C:/Users/dimir/projects` |
|
||||
| `MCP_PYTHON_DEBUG` | Enable debug logging | `false` |
|
||||
| `MCP_PYTHON_LOG_LEVEL` | Logging level | `INFO` |
|
||||
| `MCP_PYTHON_MAX_EXEC_TIME` | Command timeout (seconds) | `300` |
|
||||
|
||||
### Config File (`config.py`)
|
||||
|
||||
Customize server behavior by editing `config.py`:
|
||||
|
||||
```python
|
||||
from config import ServerConfig
|
||||
|
||||
config = ServerConfig(
|
||||
workspace_root=Path("C:/Users/dimir/projects"),
|
||||
venv_name=".venv",
|
||||
debug_mode=True,
|
||||
allowed_commands=["python", "pip", "pytest", "black", "flake8", "pylint"],
|
||||
max_execution_time=600,
|
||||
)
|
||||
```
|
||||
|
||||
## 🔌 Usage
|
||||
|
||||
### Running the Server
|
||||
|
||||
#### 🚀 With uvx (Recommended)
|
||||
|
||||
```cmd
|
||||
# Run directly without installation
|
||||
uvx --from C:/Users/dimir/proects/mcp-python mcp-python-manager
|
||||
|
||||
# With custom workspace
|
||||
uvx --from C:/Users/dimir/proects/mcp-python mcp-python-manager --workspace "C:\MyProjects"
|
||||
|
||||
# With debug mode
|
||||
uvx --from C:/Users/dimir/proects/mcp-python mcp-python-manager --debug
|
||||
|
||||
# SSE transport
|
||||
uvx --from C:/Users/dimir/proects/mcp-python mcp-python-manager --transport sse --port 8000
|
||||
```
|
||||
|
||||
#### 🐍 With Python (Traditional)
|
||||
|
||||
**Stdio Transport (Default for MCP clients):**
|
||||
```cmd
|
||||
# Direct execution
|
||||
python server.py
|
||||
|
||||
# Via MCP stdio module
|
||||
python -m mcp.server.stdio server:main
|
||||
```
|
||||
|
||||
**SSE Transport (HTTP-based clients):**
|
||||
```cmd
|
||||
python server.py --transport sse --host localhost --port 8000
|
||||
```
|
||||
|
||||
**With Options:**
|
||||
```cmd
|
||||
python server.py --debug --workspace "C:\MyProjects"
|
||||
```
|
||||
|
||||
### Connecting from Claude Desktop
|
||||
|
||||
#### ⚡ Using uvx (Recommended)
|
||||
|
||||
Add to your Claude Desktop config (`%APPDATA%\Claude\claude_desktop_config.json`):
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"python-manager": {
|
||||
"command": "uvx",
|
||||
"args": [
|
||||
"--from",
|
||||
"C:/Users/dimir/proects/mcp-python",
|
||||
"mcp-python-manager",
|
||||
"--transport",
|
||||
"stdio"
|
||||
],
|
||||
"env": {
|
||||
"MCP_PYTHON_WORKSPACE": "C:/Users/dimir/projects",
|
||||
"UV_NO_CACHE": "0",
|
||||
"UV_LINK_MODE": "copy"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### 🐍 Using Python (Traditional)
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"python-manager": {
|
||||
"command": "python",
|
||||
"args": [
|
||||
"C:/Users/dimir/proects/mcp-python/server.py"
|
||||
],
|
||||
"env": {
|
||||
"MCP_PYTHON_WORKSPACE": "C:/Users/dimir/projects"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Connecting from Cursor/VS Code
|
||||
|
||||
#### ⚡ Using uvx (Recommended)
|
||||
|
||||
```json
|
||||
{
|
||||
"mcp": {
|
||||
"servers": {
|
||||
"python-manager": {
|
||||
"type": "stdio",
|
||||
"command": "uvx",
|
||||
"args": [
|
||||
"--from",
|
||||
"C:/Users/dimir/proects/mcp-python",
|
||||
"mcp-python-manager",
|
||||
"--transport",
|
||||
"stdio"
|
||||
],
|
||||
"env": {
|
||||
"UV_NO_CACHE": "0",
|
||||
"UV_LINK_MODE": "copy"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### 🐍 Using Python (Traditional)
|
||||
|
||||
```json
|
||||
{
|
||||
"mcp": {
|
||||
"servers": {
|
||||
"python-manager": {
|
||||
"type": "stdio",
|
||||
"command": "python",
|
||||
"args": ["C:/Users/dimir/proects/mcp-python/server.py"],
|
||||
"env": {
|
||||
"PYTHONUNBUFFERED": "1"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 🛠️ Available Tools
|
||||
|
||||
### `get_project_info`
|
||||
Get comprehensive project information.
|
||||
```json
|
||||
{
|
||||
"project_path": "C:/Users/dimir/projects/my-app"
|
||||
}
|
||||
```
|
||||
|
||||
### `run_python_script`
|
||||
Execute a Python script.
|
||||
```json
|
||||
{
|
||||
"script_path": "main.py",
|
||||
"args": ["--config", "prod.yaml"],
|
||||
"env": {"DEBUG": "false"},
|
||||
"use_venv": true,
|
||||
"cwd": "C:/Users/dimir/projects/my-app"
|
||||
}
|
||||
```
|
||||
|
||||
### `install_package`
|
||||
Install Python packages.
|
||||
```json
|
||||
{
|
||||
"packages": ["requests", "fastapi"],
|
||||
"upgrade": true,
|
||||
"use_venv": true
|
||||
}
|
||||
```
|
||||
Or with requirements file:
|
||||
```json
|
||||
{
|
||||
"requirements_file": "requirements.txt",
|
||||
"use_venv": true
|
||||
}
|
||||
```
|
||||
|
||||
### `list_packages`
|
||||
List installed packages.
|
||||
```json
|
||||
{
|
||||
"project_path": "C:/Users/dimir/projects/my-app",
|
||||
"format": "json"
|
||||
}
|
||||
```
|
||||
|
||||
### `run_tests`
|
||||
Execute tests.
|
||||
```json
|
||||
{
|
||||
"test_path": "tests/",
|
||||
"test_framework": "pytest",
|
||||
"args": ["-x", "--cov"],
|
||||
"verbose": true
|
||||
}
|
||||
```
|
||||
|
||||
### `lint_code`
|
||||
Run code linters.
|
||||
```json
|
||||
{
|
||||
"file_path": "src/",
|
||||
"linter": "all",
|
||||
"fix": false
|
||||
}
|
||||
```
|
||||
|
||||
### `create_venv`
|
||||
Create virtual environment.
|
||||
```json
|
||||
{
|
||||
"project_path": "C:/Users/dimir/projects/new-project",
|
||||
"venv_name": ".venv",
|
||||
"python_version": "3.11"
|
||||
}
|
||||
```
|
||||
|
||||
### `get_debug_info`
|
||||
Get debugging information.
|
||||
```json
|
||||
{
|
||||
"script_path": "main.py",
|
||||
"include_stack": true
|
||||
}
|
||||
```
|
||||
Or by PID:
|
||||
```json
|
||||
{
|
||||
"pid": 12345,
|
||||
"include_stack": true
|
||||
}
|
||||
```
|
||||
|
||||
### `list_project_files`
|
||||
List project files.
|
||||
```json
|
||||
{
|
||||
"directory": "C:/Users/dimir/projects/my-app",
|
||||
"pattern": "*.py",
|
||||
"recursive": true,
|
||||
"exclude_dirs": ["__pycache__", ".git"]
|
||||
}
|
||||
```
|
||||
|
||||
### `read_file`
|
||||
Read file contents.
|
||||
```json
|
||||
{
|
||||
"file_path": "main.py",
|
||||
"start_line": 1,
|
||||
"end_line": 50,
|
||||
"encoding": "utf-8"
|
||||
}
|
||||
```
|
||||
|
||||
### `execute_command`
|
||||
Execute allowed shell commands.
|
||||
```json
|
||||
{
|
||||
"command": "python -m pytest tests/ -v",
|
||||
"cwd": "C:/Users/dimir/projects/my-app",
|
||||
"timeout": 120
|
||||
}
|
||||
```
|
||||
|
||||
### `get_python_env`
|
||||
Get Python environment info.
|
||||
```json
|
||||
{
|
||||
"project_path": "C:/Users/dimir/projects/my-app"
|
||||
}
|
||||
```
|
||||
|
||||
### `format_code`
|
||||
Format Python code.
|
||||
```json
|
||||
{
|
||||
"file_path": "src/",
|
||||
"formatter": "black",
|
||||
"check_only": false
|
||||
}
|
||||
```
|
||||
|
||||
### `analyze_dependencies`
|
||||
Analyze project dependencies.
|
||||
```json
|
||||
{
|
||||
"project_path": "C:/Users/dimir/projects/my-app",
|
||||
"check_updates": false,
|
||||
"check_security": false
|
||||
}
|
||||
```
|
||||
|
||||
### `watch_files`
|
||||
Configure file watching.
|
||||
```json
|
||||
{
|
||||
"directory": "C:/Users/dimir/projects/my-app/src",
|
||||
"patterns": ["*.py", "*.json"],
|
||||
"recursive": true
|
||||
}
|
||||
```
|
||||
|
||||
## 🔒 Security
|
||||
|
||||
### Allowed Commands
|
||||
By default, only these commands can be executed:
|
||||
- `python` - Run Python scripts
|
||||
- `pip` - Package management
|
||||
- `pytest` - Run tests
|
||||
- `black` - Code formatting
|
||||
- `flake8` - Linting
|
||||
- `pylint` - Advanced linting
|
||||
|
||||
Modify `config.allowed_commands` to customize.
|
||||
|
||||
### Path Validation
|
||||
All file paths are validated to prevent directory traversal attacks.
|
||||
|
||||
### Output Truncation
|
||||
Command output is limited to `max_output_length` characters (default: 50,000).
|
||||
|
||||
## 🐛 Debugging
|
||||
|
||||
### Enable Debug Logging
|
||||
```cmd
|
||||
set MCP_PYTHON_DEBUG=true
|
||||
set MCP_PYTHON_LOG_LEVEL=DEBUG
|
||||
python server.py
|
||||
```
|
||||
|
||||
### Log File
|
||||
Configure logging to file in `config.py`:
|
||||
```python
|
||||
config.log_file = Path("C:/Users/dimir/proects/mcp-python/server.log")
|
||||
```
|
||||
|
||||
### Common Issues
|
||||
|
||||
| Issue | Solution |
|
||||
|-------|----------|
|
||||
| "Command not allowed" | Add command to `config.allowed_commands` |
|
||||
| "Virtual environment not found" | Create venv with `create_venv` tool or manually |
|
||||
| "Timeout executing command" | Increase `max_execution_time` in config |
|
||||
| "Permission denied" | Run terminal as Administrator or check file permissions |
|
||||
|
||||
## 🧪 Testing the Server
|
||||
|
||||
### Manual Test with MCP Inspector
|
||||
```cmd
|
||||
# Install MCP inspector
|
||||
npm install -g @modelcontextprotocol/inspector
|
||||
|
||||
# Run server and inspector
|
||||
python server.py
|
||||
# In another terminal:
|
||||
mcp-inspector
|
||||
```
|
||||
|
||||
### Python Test Script
|
||||
```python
|
||||
import asyncio
|
||||
from mcp.client.session import ClientSession
|
||||
from mcp.client.stdio import stdio_client
|
||||
|
||||
async def test_server():
|
||||
async with stdio_client(["python", "server.py"]) as (read, write):
|
||||
async with ClientSession(read, write) as session:
|
||||
await session.initialize()
|
||||
|
||||
# List available tools
|
||||
tools = await session.list_tools()
|
||||
print(f"Available tools: {[t.name for t in tools.tools]}")
|
||||
|
||||
# Test get_project_info
|
||||
result = await session.call_tool(
|
||||
"get_project_info",
|
||||
{"project_path": "C:/Users/dimir/projects"}
|
||||
)
|
||||
print(result)
|
||||
|
||||
asyncio.run(test_server())
|
||||
```
|
||||
|
||||
## 📁 Project Structure
|
||||
|
||||
```
|
||||
mcp-python/
|
||||
├── server.py # Main server entry point
|
||||
├── tools.py # MCP tool implementations
|
||||
├── config.py # Configuration settings
|
||||
├── requirements.txt # Python dependencies
|
||||
├── README.md # This file
|
||||
├── .gitignore # Git ignore rules
|
||||
└── logs/ # Log files (created at runtime)
|
||||
```
|
||||
|
||||
## 🔄 Development
|
||||
|
||||
### Adding New Tools
|
||||
|
||||
1. Add tool definition in `tools.py` `_register_tools()` method
|
||||
2. Implement the async method in `PythonProjectTools` class
|
||||
3. Add handler case in `handle_tool_call()` method
|
||||
4. Update this README with documentation
|
||||
|
||||
### Example Tool Addition
|
||||
```python
|
||||
# In _register_tools():
|
||||
Tool(
|
||||
name="my_new_tool",
|
||||
description="What this tool does",
|
||||
inputSchema={...}
|
||||
)
|
||||
|
||||
# Implementation:
|
||||
async def my_new_tool(self, arg1: str) -> ToolResult:
|
||||
# Your logic here
|
||||
return ToolResult(success=True, message="Done", data={...})
|
||||
|
||||
# Handler:
|
||||
elif name == "my_new_tool":
|
||||
result = await self.my_new_tool(**arguments)
|
||||
```
|
||||
|
||||
## 📄 License
|
||||
|
||||
MIT License - Feel free to use and modify for your projects.
|
||||
|
||||
## 🤝 Contributing
|
||||
|
||||
1. Fork the repository
|
||||
2. Create a feature branch
|
||||
3. Add tests for new functionality
|
||||
4. Submit a pull request
|
||||
|
||||
## 🔗 Resources
|
||||
|
||||
- [MCP Specification](https://modelcontextprotocol.io)
|
||||
- [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk)
|
||||
- [Windows Python Setup Guide](https://docs.python.org/3/using/windows.html)
|
||||
|
||||
---
|
||||
|
||||
**Author**: dimir
|
||||
**Created**: 2026
|
||||
**Platform**: Windows 11, Python 3.10+
|
||||
+274
@@ -0,0 +1,274 @@
|
||||
# ⚡ Using MCP Python Manager with uvx
|
||||
|
||||
This guide explains how to use the MCP Python Project Manager server with [`uv`](https://github.com/astral-sh/uv) and `uvx` for faster, simpler execution.
|
||||
|
||||
## Why uvx?
|
||||
|
||||
✅ **No virtual environment setup** - Run directly without `python -m venv`
|
||||
✅ **Instant startup** - uv's caching makes repeated runs lightning fast
|
||||
✅ **Dependency isolation** - Each run uses isolated dependencies
|
||||
✅ **Cross-platform** - Works the same on Windows, macOS, and Linux
|
||||
✅ **Automatic updates** - uvx fetches the latest version automatically
|
||||
|
||||
## 🚀 Quick Start
|
||||
|
||||
### Install uv (one-time)
|
||||
|
||||
```cmd
|
||||
# Via winget (Windows)
|
||||
winget install astral-sh.uv
|
||||
|
||||
# Or via pip
|
||||
pip install uv
|
||||
|
||||
# Verify installation
|
||||
uv --version
|
||||
uvx --version
|
||||
```
|
||||
|
||||
### Run the MCP Server
|
||||
|
||||
```cmd
|
||||
# Basic run (recommended for MCP clients)
|
||||
uvx --from C:/Users/dimir/proects/mcp-python mcp-python-manager
|
||||
|
||||
# With custom workspace
|
||||
uvx --from C:/Users/dimir/proects/mcp-python mcp-python-manager --workspace "C:\MyProjects"
|
||||
|
||||
# With debug logging
|
||||
uvx --from C:/Users/dimir/proects/mcp-python mcp-python-manager --debug
|
||||
|
||||
# Via SSE transport
|
||||
uvx --from C:/Users/dimir/proects/mcp-python mcp-python-manager --transport sse --port 8000
|
||||
```
|
||||
|
||||
### Run from Project Directory
|
||||
|
||||
If you're already in the project directory:
|
||||
|
||||
```cmd
|
||||
cd C:\Users\dimir\proects\mcp-python
|
||||
uvx --from . mcp-python-manager
|
||||
```
|
||||
|
||||
## 🔌 Claude Desktop Configuration
|
||||
|
||||
Add to `%APPDATA%\Claude\claude_desktop_config.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"python-manager": {
|
||||
"command": "uvx",
|
||||
"args": [
|
||||
"--from",
|
||||
"C:/Users/dimir/proects/mcp-python",
|
||||
"mcp-python-manager",
|
||||
"--transport",
|
||||
"stdio"
|
||||
],
|
||||
"env": {
|
||||
"MCP_PYTHON_WORKSPACE": "C:/Users/dimir/projects",
|
||||
"UV_NO_CACHE": "0",
|
||||
"UV_LINK_MODE": "copy",
|
||||
"PYTHONUNBUFFERED": "1"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Environment Variables Explained
|
||||
|
||||
| Variable | Purpose | Recommended Value |
|
||||
|----------|---------|------------------|
|
||||
| `MCP_PYTHON_WORKSPACE` | Root directory for Python projects | `C:/Users/dimir/projects` |
|
||||
| `UV_NO_CACHE` | Disable uv cache (0 = use cache) | `0` |
|
||||
| `UV_LINK_MODE` | How uv links packages (`copy`, `symlink`, `hardlink`) | `copy` (safest on Windows) |
|
||||
| `PYTHONUNBUFFERED` | Disable Python output buffering | `1` |
|
||||
|
||||
## 🔧 Cursor / VS Code Configuration
|
||||
|
||||
```json
|
||||
{
|
||||
"mcp": {
|
||||
"servers": {
|
||||
"python-manager": {
|
||||
"type": "stdio",
|
||||
"command": "uvx",
|
||||
"args": [
|
||||
"--from",
|
||||
"C:/Users/dimir/proects/mcp-python",
|
||||
"mcp-python-manager",
|
||||
"--transport",
|
||||
"stdio"
|
||||
],
|
||||
"env": {
|
||||
"MCP_PYTHON_WORKSPACE": "C:/Users/dimir/projects",
|
||||
"UV_LINK_MODE": "copy"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 🛠️ Development with uvx
|
||||
|
||||
### Test Changes Locally
|
||||
|
||||
```cmd
|
||||
# After editing server.py or tools.py, test immediately:
|
||||
uvx --from C:/Users/dimir/proects/mcp-python mcp-python-manager --debug
|
||||
|
||||
# No need to reinstall - uvx picks up local changes!
|
||||
```
|
||||
|
||||
### Install for Development
|
||||
|
||||
```cmd
|
||||
# Install with dev dependencies
|
||||
uv pip install -e ".[dev]" --system
|
||||
|
||||
# Run tests
|
||||
uv run pytest tests/ -v
|
||||
|
||||
# Run linting
|
||||
uv run ruff check .
|
||||
uv run black --check .
|
||||
```
|
||||
|
||||
### Build and Publish (Optional)
|
||||
|
||||
```cmd
|
||||
# Build distribution
|
||||
uv build
|
||||
|
||||
# Publish to PyPI (requires token)
|
||||
uv publish --token $PYPI_TOKEN
|
||||
```
|
||||
|
||||
## 🐛 Troubleshooting uvx
|
||||
|
||||
### "Command not found: uvx"
|
||||
|
||||
```cmd
|
||||
# Install uv
|
||||
winget install astral-sh.uv
|
||||
# or
|
||||
pip install uv
|
||||
|
||||
# Ensure it's in PATH
|
||||
where uvx
|
||||
```
|
||||
|
||||
### Permission errors on Windows
|
||||
|
||||
```cmd
|
||||
# Use copy link mode (safer than symlinks on Windows)
|
||||
set UV_LINK_MODE=copy
|
||||
uvx --from . mcp-python-manager
|
||||
|
||||
# Or run as Administrator if needed
|
||||
```
|
||||
|
||||
### Cache issues
|
||||
|
||||
```cmd
|
||||
# Clear uv cache
|
||||
uv cache clean
|
||||
|
||||
# Disable cache for one run
|
||||
uvx --no-cache --from . mcp-python-manager
|
||||
```
|
||||
|
||||
### Slow first run
|
||||
|
||||
The first `uvx` run downloads dependencies. Subsequent runs are instant due to caching.
|
||||
|
||||
```cmd
|
||||
# Pre-warm cache (optional)
|
||||
uvx --from . mcp-python-manager --help
|
||||
```
|
||||
|
||||
### Debug uvx behavior
|
||||
|
||||
```cmd
|
||||
# Enable uv debug output
|
||||
set UV_VERBOSE=1
|
||||
uvx --from . mcp-python-manager --debug
|
||||
|
||||
# See what uvx is doing
|
||||
set RUST_LOG=uv=debug
|
||||
uvx --from . mcp-python-manager
|
||||
```
|
||||
|
||||
## 📊 Performance Comparison
|
||||
|
||||
| Method | First Run | Subsequent Runs | Setup Time |
|
||||
|--------|-----------|----------------|------------|
|
||||
| `python server.py` + venv | ~30s | ~1s | ~2 min (venv + pip) |
|
||||
| `uvx --from .` | ~15s | **~0.5s** | **0s** |
|
||||
| `pip install -e .` + run | ~45s | ~1s | ~3 min |
|
||||
|
||||
## 🔄 Updating the Server
|
||||
|
||||
With uvx, updates are automatic:
|
||||
|
||||
```cmd
|
||||
# Just run again - uvx fetches latest code
|
||||
uvx --from C:/Users/dimir/proects/mcp-python mcp-python-manager
|
||||
|
||||
# Or force refresh
|
||||
uv cache clean mcp-python-manager
|
||||
uvx --from C:/Users/dimir/proects/mcp-python mcp-python-manager
|
||||
```
|
||||
|
||||
## 📁 Project Structure for uvx
|
||||
|
||||
```
|
||||
mcp-python/
|
||||
├── pyproject.toml # [project.scripts] defines entry points
|
||||
├── server.py # Contains run_server() entry point
|
||||
├── .uvrc # uv-specific configuration (optional)
|
||||
└── ...
|
||||
```
|
||||
|
||||
### Key pyproject.toml Settings
|
||||
|
||||
```toml
|
||||
[project.scripts]
|
||||
# This creates the 'mcp-python-manager' command
|
||||
mcp-python-manager = "server:run_server"
|
||||
|
||||
[tool.uv]
|
||||
# uv-specific optimizations
|
||||
dev-dependencies = ["dev"]
|
||||
```
|
||||
|
||||
## 🎯 Best Practices
|
||||
|
||||
1. **Use `--from .` when in project directory** - Faster than full path
|
||||
2. **Set `UV_LINK_MODE=copy` on Windows** - Avoids symlink permission issues
|
||||
3. **Keep `MCP_PYTHON_WORKSPACE` in env** - Consistent project access
|
||||
4. **Use `--debug` during development** - See detailed logs
|
||||
5. **Cache warmup** - Run `--help` once to pre-download dependencies
|
||||
|
||||
## 🔄 Switching Back to Python
|
||||
|
||||
If you need to use traditional Python:
|
||||
|
||||
```cmd
|
||||
# Traditional setup
|
||||
python -m venv .venv
|
||||
.venv\Scripts\activate
|
||||
pip install -r requirements.txt
|
||||
python server.py
|
||||
```
|
||||
|
||||
Both methods work - choose what fits your workflow!
|
||||
|
||||
---
|
||||
|
||||
**uv Documentation**: https://docs.astral.sh/uv/
|
||||
**MCP Specification**: https://modelcontextprotocol.io
|
||||
@@ -0,0 +1,31 @@
|
||||
{
|
||||
"mcpServers": {
|
||||
"python-manager": {
|
||||
"command": "uvx",
|
||||
"args": [
|
||||
"--from",
|
||||
"C:/Users/dimir/proects/mcp-python",
|
||||
"mcp-python-manager",
|
||||
"--transport",
|
||||
"stdio"
|
||||
],
|
||||
"env": {
|
||||
"MCP_PYTHON_WORKSPACE": "C:/Users/dimir/projects",
|
||||
"MCP_PYTHON_DEBUG": "false",
|
||||
"MCP_PYTHON_LOG_LEVEL": "INFO",
|
||||
"PYTHONUNBUFFERED": "1"
|
||||
},
|
||||
"disabled": false,
|
||||
"autoApprove": [],
|
||||
"alwaysAllow": [
|
||||
"get_project_info",
|
||||
"list_project_files",
|
||||
"read_file",
|
||||
"list_packages",
|
||||
"get_python_env",
|
||||
"get_debug_info"
|
||||
],
|
||||
"description": "MCP server for managing and debugging Python projects on Windows 11"
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,110 @@
|
||||
"""
|
||||
Configuration settings for MCP Python Project Manager Server.
|
||||
"""
|
||||
import os
|
||||
from pathlib import Path
|
||||
from typing import Optional, List
|
||||
from pydantic import BaseModel, Field, field_validator
|
||||
|
||||
|
||||
class ServerConfig(BaseModel):
|
||||
"""Main server configuration."""
|
||||
|
||||
# Server settings
|
||||
server_name: str = Field(default="mcp-python-manager", description="Name of the MCP server")
|
||||
version: str = Field(default="1.0.0", description="Server version")
|
||||
|
||||
# Paths
|
||||
workspace_root: Path = Field(
|
||||
default=Path("C:/Users/dimir/projects"),
|
||||
description="Root directory for Python projects"
|
||||
)
|
||||
venv_name: str = Field(default=".venv", description="Default virtual environment name")
|
||||
|
||||
# Python settings
|
||||
python_executable: Optional[str] = Field(
|
||||
default=None,
|
||||
description="Path to Python executable (auto-detected if None)"
|
||||
)
|
||||
default_python_version: str = Field(default="3.11", description="Default Python version")
|
||||
|
||||
# Debug settings
|
||||
debug_mode: bool = Field(default=False, description="Enable debug logging")
|
||||
log_level: str = Field(default="INFO", description="Logging level")
|
||||
log_file: Optional[Path] = Field(default=None, description="Path to log file")
|
||||
|
||||
# Tool settings
|
||||
max_execution_time: int = Field(default=300, description="Max execution time for commands (seconds)")
|
||||
max_output_length: int = Field(default=50000, description="Max characters in command output")
|
||||
allowed_commands: List[str] = Field(
|
||||
default_factory=lambda: ["python", "pip", "pytest", "black", "flake8", "pylint"],
|
||||
description="List of allowed shell commands"
|
||||
)
|
||||
|
||||
# File watching
|
||||
enable_file_watching: bool = Field(default=True, description="Enable file change notifications")
|
||||
watch_patterns: List[str] = Field(
|
||||
default_factory=lambda: ["*.py", "*.txt", "*.md", "requirements*.txt"],
|
||||
description="File patterns to watch"
|
||||
)
|
||||
ignore_patterns: List[str] = Field(
|
||||
default_factory=lambda: ["__pycache__", "*.pyc", ".git", ".venv", "node_modules"],
|
||||
description="Patterns to ignore when watching"
|
||||
)
|
||||
|
||||
@field_validator('workspace_root', 'log_file', mode='before')
|
||||
@classmethod
|
||||
def convert_to_path(cls, v):
|
||||
if isinstance(v, str):
|
||||
return Path(v)
|
||||
return v
|
||||
|
||||
@field_validator('log_level')
|
||||
@classmethod
|
||||
def validate_log_level(cls, v):
|
||||
valid_levels = ["DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"]
|
||||
if v.upper() not in valid_levels:
|
||||
raise ValueError(f"log_level must be one of {valid_levels}")
|
||||
return v.upper()
|
||||
|
||||
|
||||
class ProjectConfig(BaseModel):
|
||||
"""Per-project configuration."""
|
||||
|
||||
name: str
|
||||
path: Path
|
||||
python_version: Optional[str] = None
|
||||
venv_path: Optional[Path] = None
|
||||
entry_point: Optional[str] = None
|
||||
test_command: str = Field(default="pytest", description="Command to run tests")
|
||||
run_args: List[str] = Field(default_factory=list, description="Default arguments for running")
|
||||
|
||||
@field_validator('path', 'venv_path', mode='before')
|
||||
@classmethod
|
||||
def convert_to_path(cls, v):
|
||||
if isinstance(v, str):
|
||||
return Path(v)
|
||||
return v
|
||||
|
||||
|
||||
# Global config instance
|
||||
config = ServerConfig()
|
||||
|
||||
|
||||
def load_config_from_env():
|
||||
"""Load configuration from environment variables."""
|
||||
import os
|
||||
|
||||
if os.getenv("MCP_PYTHON_WORKSPACE"):
|
||||
config.workspace_root = Path(os.getenv("MCP_PYTHON_WORKSPACE"))
|
||||
|
||||
if os.getenv("MCP_PYTHON_DEBUG") == "true":
|
||||
config.debug_mode = True
|
||||
|
||||
if os.getenv("MCP_PYTHON_LOG_LEVEL"):
|
||||
config.log_level = os.getenv("MCP_PYTHON_LOG_LEVEL")
|
||||
|
||||
if os.getenv("MCP_PYTHON_MAX_EXEC_TIME"):
|
||||
config.max_execution_time = int(os.getenv("MCP_PYTHON_MAX_EXEC_TIME"))
|
||||
|
||||
return config
|
||||
@@ -0,0 +1,36 @@
|
||||
[build-system]
|
||||
requires = ["setuptools>=61.0", "wheel"]
|
||||
build-backend = "setuptools.build_meta"
|
||||
|
||||
[project]
|
||||
name = "mcp-python-manager"
|
||||
version = "0.1.0"
|
||||
description = "MCP Server for managing Python projects on Windows"
|
||||
requires-python = ">=3.10"
|
||||
readme = "README.md"
|
||||
license = {text = "MIT"}
|
||||
|
||||
# These are the specific files that need to be installed as modules
|
||||
# so that 'server.py' and its imports work inside the uvx environment.
|
||||
dependencies = [
|
||||
"mcp>=1.0.0",
|
||||
"pydantic>=2.0.0",
|
||||
"rich>=13.0.0",
|
||||
"psutil>=5.9.0",
|
||||
"shellingham>=1.5.0",
|
||||
"autopep8",
|
||||
"flake8",
|
||||
"black",
|
||||
"pytest",
|
||||
]
|
||||
|
||||
[project.scripts]
|
||||
# This defines the command 'mcp-python-manager' that runs server.run_server()
|
||||
mcp-python-manager = "server:run_server"
|
||||
|
||||
# CRITICAL FIX: Explicitly include root-level Python modules
|
||||
[tool.setuptools]
|
||||
py-modules = ["server", "tools", "config"]
|
||||
|
||||
[tool.uv]
|
||||
# Configuration for uv behavior
|
||||
@@ -0,0 +1,13 @@
|
||||
# MCP Python Project Manager - Dependencies
|
||||
mcp>=1.0.0
|
||||
pydantic>=2.0.0
|
||||
python-dotenv>=1.0.0
|
||||
watchdog>=3.0.0
|
||||
black>=24.0.0
|
||||
flake8>=7.0.0
|
||||
pylint>=3.0.0
|
||||
pytest>=8.0.0
|
||||
virtualenv>=20.25.0
|
||||
psutil>=5.9.0
|
||||
rich>=13.0.0
|
||||
typer>=0.9.0
|
||||
@@ -0,0 +1,61 @@
|
||||
import sys
|
||||
import os
|
||||
import logging
|
||||
import asyncio
|
||||
from typing import List, Dict, Any, Sequence
|
||||
|
||||
# MCP Imports
|
||||
from mcp.server import Server
|
||||
from mcp.server.stdio import stdio_server
|
||||
from mcp.types import Tool, TextContent
|
||||
|
||||
# Import tools from local file
|
||||
import tools
|
||||
|
||||
# Настройка логирования
|
||||
logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s")
|
||||
logger = logging.getLogger("mcp-python-server")
|
||||
|
||||
# Инициализация сервера
|
||||
app = Server("mcp-python-manager")
|
||||
|
||||
# --- Регистрация инструментов ---
|
||||
|
||||
@app.list_tools()
|
||||
async def list_tools() -> List[Tool]:
|
||||
"""Возвращает список доступных инструментов."""
|
||||
return tools.get_tool_definitions()
|
||||
|
||||
@app.call_tool()
|
||||
async def call_tool(name: str, arguments: Dict[str, Any]) -> Sequence[TextContent]:
|
||||
"""Вызывает конкретный инструмент."""
|
||||
logger.info(f"Вызов инструмента: {name}")
|
||||
try:
|
||||
# Выполняем логику из tools.py
|
||||
result_text = await tools.execute_tool(name, arguments)
|
||||
return [TextContent(type="text", text=str(result_text))]
|
||||
except Exception as e:
|
||||
logger.error(f"Ошибка в инструменте {name}: {e}")
|
||||
return [TextContent(type="text", text=f"Ошибка выполнения: {str(e)}")]
|
||||
|
||||
# --- Запуск сервера ---
|
||||
|
||||
async def main():
|
||||
"""Основная функция запуска."""
|
||||
logger.info("Запуск MCP сервера на stdio...")
|
||||
# Запуск сервера через стандартный ввод/вывод
|
||||
async with stdio_server() as streams:
|
||||
await app.run(*streams, app.create_initialization_options())
|
||||
|
||||
def run_server():
|
||||
"""Точка входа для uvx."""
|
||||
try:
|
||||
asyncio.run(main())
|
||||
except KeyboardInterrupt:
|
||||
logger.info("Сервер остановлен пользователем.")
|
||||
except Exception as e:
|
||||
logger.critical(f"Критическая ошибка сервера: {e}")
|
||||
sys.exit(1)
|
||||
|
||||
if __name__ == "__main__":
|
||||
run_server()
|
||||
@@ -0,0 +1,192 @@
|
||||
@echo off
|
||||
REM MCP Python Project Manager - Windows Startup Script
|
||||
REM Save as: start-server.bat
|
||||
|
||||
setlocal enabledelayedexpansion
|
||||
|
||||
REM Configuration
|
||||
set PROJECT_DIR=C:\Users\dimir\proects\mcp-python
|
||||
set VENV_DIR=%PROJECT_DIR%\.venv
|
||||
set PYTHON_EXE=%VENV_DIR%\Scripts\python.exe
|
||||
|
||||
REM Parse arguments
|
||||
set TRANSPORT=stdio
|
||||
set DEBUG=false
|
||||
set WORKSPACE=
|
||||
set USE_UVX=false
|
||||
|
||||
:parse_args
|
||||
if "%~1"=="" goto :end_parse
|
||||
if /i "%~1"=="--debug" (
|
||||
set DEBUG=true
|
||||
shift
|
||||
goto :parse_args
|
||||
)
|
||||
if /i "%~1"=="--sse" (
|
||||
set TRANSPORT=sse
|
||||
shift
|
||||
goto :parse_args
|
||||
)
|
||||
if /i "%~1"=="--workspace" (
|
||||
set WORKSPACE=%~2
|
||||
shift
|
||||
shift
|
||||
goto :parse_args
|
||||
)
|
||||
if /i "%~1"=="--uvx" (
|
||||
set USE_UVX=true
|
||||
shift
|
||||
goto :parse_args
|
||||
)
|
||||
if /i "%~1"=="--help" (
|
||||
goto :show_help
|
||||
)
|
||||
shift
|
||||
goto :parse_args
|
||||
:end_parse
|
||||
|
||||
echo ========================================
|
||||
echo MCP Python Project Manager Server
|
||||
echo ========================================
|
||||
echo.
|
||||
|
||||
REM Check if using uvx mode
|
||||
if "%USE_UVX%"=="true" (
|
||||
goto :run_with_uvx
|
||||
)
|
||||
|
||||
REM Traditional Python mode
|
||||
|
||||
REM Check if Python is available
|
||||
where python >nul 2>&1
|
||||
if errorlevel 1 (
|
||||
echo [ERROR] Python not found in PATH
|
||||
echo Please install Python 3.10+ from https://python.org
|
||||
pause
|
||||
exit /b 1
|
||||
)
|
||||
|
||||
REM Check/create virtual environment
|
||||
if not exist "%PYTHON_EXE%" (
|
||||
echo [INFO] Creating virtual environment...
|
||||
python -m venv "%VENV_DIR%"
|
||||
if errorlevel 1 (
|
||||
echo [ERROR] Failed to create virtual environment
|
||||
pause
|
||||
exit /b 1
|
||||
)
|
||||
)
|
||||
|
||||
REM Activate virtual environment
|
||||
call "%VENV_DIR%\Scripts\activate.bat"
|
||||
if errorlevel 1 (
|
||||
echo [ERROR] Failed to activate virtual environment
|
||||
pause
|
||||
exit /b 1
|
||||
)
|
||||
|
||||
REM Install dependencies if needed
|
||||
if not exist "%VENV_DIR%\Lib\site-packages\mcp" (
|
||||
echo [INFO] Installing dependencies...
|
||||
pip install -r "%PROJECT_DIR%\requirements.txt"
|
||||
if errorlevel 1 (
|
||||
echo [WARNING] Some dependencies may have failed to install
|
||||
)
|
||||
)
|
||||
|
||||
REM Set environment variables
|
||||
set MCP_PYTHON_WORKSPACE=%WORKSPACE:C:/Users/dimir/projects=%
|
||||
if "%DEBUG%"=="true" (
|
||||
set MCP_PYTHON_DEBUG=true
|
||||
set MCP_PYTHON_LOG_LEVEL=DEBUG
|
||||
echo [DEBUG] Debug mode enabled
|
||||
)
|
||||
|
||||
REM Build command
|
||||
set SERVER_CMD=%PYTHON_EXE% "%PROJECT_DIR%\server.py" --transport %TRANSPORT%
|
||||
if "%WORKSPACE%" neq "" (
|
||||
set SERVER_CMD=!SERVER_CMD! --workspace "%WORKSPACE%"
|
||||
)
|
||||
if "%DEBUG%"=="true" (
|
||||
set SERVER_CMD=!SERVER_CMD! --debug
|
||||
)
|
||||
|
||||
echo [INFO] Starting server with %TRANSPORT% transport...
|
||||
echo [INFO] Workspace: %MCP_PYTHON_WORKSPACE%
|
||||
echo [INFO] Press Ctrl+C to stop the server
|
||||
echo.
|
||||
|
||||
REM Run server
|
||||
%SERVER_CMD%
|
||||
set EXIT_CODE=%ERRORLEVEL%
|
||||
|
||||
REM Deactivate virtual environment
|
||||
deactivate
|
||||
|
||||
goto :exit_handler
|
||||
|
||||
:run_with_uvx
|
||||
REM Check if uv/uvx is available
|
||||
where uvx >nul 2>&1
|
||||
if errorlevel 1 (
|
||||
echo [ERROR] uvx not found in PATH
|
||||
echo Please install uv: winget install astral-sh.uv
|
||||
echo or: pip install uv
|
||||
pause
|
||||
exit /b 1
|
||||
)
|
||||
|
||||
echo [INFO] Running with uvx (no venv needed!)...
|
||||
|
||||
REM Build uvx command
|
||||
set UVX_CMD=uvx --from "%PROJECT_DIR%" mcp-python-manager --transport %TRANSPORT%
|
||||
if "%WORKSPACE%" neq "" (
|
||||
set UVX_CMD=!UVX_CMD! --workspace "%WORKSPACE%"
|
||||
)
|
||||
if "%DEBUG%"=="true" (
|
||||
set UVX_CMD=!UVX_CMD! --debug
|
||||
set UV_NO_CACHE=0
|
||||
)
|
||||
|
||||
set MCP_PYTHON_WORKSPACE=%WORKSPACE:C:/Users/dimir/projects=%
|
||||
echo [INFO] Workspace: %MCP_PYTHON_WORKSPACE%
|
||||
echo [INFO] Press Ctrl+C to stop the server
|
||||
echo.
|
||||
|
||||
REM Run server with uvx
|
||||
%UVX_CMD%
|
||||
set EXIT_CODE=%ERRORLEVEL%
|
||||
|
||||
:exit_handler
|
||||
if %EXIT_CODE% equ 0 (
|
||||
echo.
|
||||
echo [INFO] Server stopped normally
|
||||
) else (
|
||||
echo.
|
||||
echo [ERROR] Server exited with code %EXIT_CODE%
|
||||
)
|
||||
|
||||
pause
|
||||
exit /b %EXIT_CODE%
|
||||
|
||||
:show_help
|
||||
echo Usage: start-server.bat [options]
|
||||
echo.
|
||||
echo Options:
|
||||
echo --debug Enable debug logging
|
||||
echo --sse Use SSE transport instead of stdio
|
||||
echo --workspace Set custom workspace directory
|
||||
echo --uvx Use uvx instead of python/venv (recommended)
|
||||
echo --help Show this help message
|
||||
echo.
|
||||
echo Examples:
|
||||
echo start-server.bat
|
||||
echo start-server.bat --debug
|
||||
echo start-server.bat --sse --port 8080
|
||||
echo start-server.bat --workspace "D:\MyProjects"
|
||||
echo start-server.bat --uvx --debug ^(Recommended!^)
|
||||
echo.
|
||||
echo Prerequisites for --uvx:
|
||||
echo Install uv: winget install astral-sh.uv
|
||||
echo or: pip install uv
|
||||
exit /b 0
|
||||
+217
@@ -0,0 +1,217 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
Test script for MCP Python Project Manager Server.
|
||||
Run this to verify the server is working correctly.
|
||||
"""
|
||||
import asyncio
|
||||
import sys
|
||||
import json
|
||||
from pathlib import Path
|
||||
|
||||
# Add parent directory to path for imports
|
||||
sys.path.insert(0, str(Path(__file__).parent))
|
||||
|
||||
from tools import PythonProjectTools, ToolResult
|
||||
from config import config
|
||||
|
||||
|
||||
async def test_tools():
|
||||
"""Test all tool implementations."""
|
||||
print("🧪 Testing MCP Python Project Manager Tools\n")
|
||||
|
||||
# Mock server object for testing
|
||||
class MockServer:
|
||||
def list_tools(self):
|
||||
def decorator(func):
|
||||
return func
|
||||
return decorator
|
||||
def call_tool(self):
|
||||
def decorator(func):
|
||||
return func
|
||||
return decorator
|
||||
|
||||
mock_server = MockServer()
|
||||
tools = PythonProjectTools(mock_server)
|
||||
|
||||
test_results = []
|
||||
|
||||
# Test 1: Get Python environment
|
||||
print("1. Testing get_python_env...")
|
||||
result = await tools.get_python_env()
|
||||
test_results.append(("get_python_env", result.success))
|
||||
if result.success:
|
||||
print(f" ✓ Python: {result.data.get('python_version', 'N/A')}")
|
||||
else:
|
||||
print(f" ✗ Error: {result.error}")
|
||||
|
||||
# Test 2: List packages
|
||||
print("\n2. Testing list_packages...")
|
||||
result = await tools.list_packages(format="json")
|
||||
test_results.append(("list_packages", result.success))
|
||||
if result.success and result.data:
|
||||
print(f" ✓ Found {len(result.data)} packages")
|
||||
else:
|
||||
print(f" ⚠ Warning: {result.message}")
|
||||
|
||||
# Test 3: Get project info (test with current directory)
|
||||
print("\n3. Testing get_project_info...")
|
||||
current_dir = str(Path(__file__).parent)
|
||||
result = await tools.get_project_info(current_dir)
|
||||
test_results.append(("get_project_info", result.success))
|
||||
if result.success:
|
||||
print(f" ✓ Project: {result.data.get('name', 'N/A')}")
|
||||
print(f" ✓ Python files: {result.data.get('files', {}).get('python_files', 0)}")
|
||||
else:
|
||||
print(f" ✗ Error: {result.error}")
|
||||
|
||||
# Test 4: List project files
|
||||
print("\n4. Testing list_project_files...")
|
||||
result = await tools.list_project_files(current_dir, pattern="*.py", recursive=False)
|
||||
test_results.append(("list_project_files", result.success))
|
||||
if result.success:
|
||||
print(f" ✓ Found {result.data.get('count', 0)} Python files")
|
||||
else:
|
||||
print(f" ✗ Error: {result.error}")
|
||||
|
||||
# Test 5: Read a file
|
||||
print("\n5. Testing read_file...")
|
||||
config_file = str(Path(__file__).parent / "config.py")
|
||||
result = await tools.read_file(config_file, start_line=1, end_line=10)
|
||||
test_results.append(("read_file", result.success))
|
||||
if result.success:
|
||||
lines = result.data.get("content", "").count("\n") + 1
|
||||
print(f" ✓ Read {lines} lines from config.py")
|
||||
else:
|
||||
print(f" ✗ Error: {result.error}")
|
||||
|
||||
# Test 6: Lint code (check only)
|
||||
print("\n6. Testing lint_code (check mode)...")
|
||||
result = await tools.lint_code(current_dir, linter="flake8", fix=False)
|
||||
test_results.append(("lint_code", True)) # Success even if linting finds issues
|
||||
if result.success:
|
||||
print(f" ✓ Linting completed")
|
||||
else:
|
||||
print(f" ⚠ Linting issues found (expected): {result.message}")
|
||||
|
||||
# Test 7: Analyze dependencies
|
||||
print("\n7. Testing analyze_dependencies...")
|
||||
result = await tools.analyze_dependencies(current_dir)
|
||||
test_results.append(("analyze_dependencies", result.success))
|
||||
if result.success:
|
||||
files = result.data.get("files", [])
|
||||
print(f" ✓ Analyzed {len(files)} requirements file(s)")
|
||||
else:
|
||||
print(f" ⚠ {result.message}")
|
||||
|
||||
# Test 8: Get debug info
|
||||
print("\n8. Testing get_debug_info...")
|
||||
result = await tools.get_debug_info()
|
||||
test_results.append(("get_debug_info", result.success))
|
||||
if result.success:
|
||||
procs = result.data.get("python_processes", [])
|
||||
print(f" ✓ Found {len(procs)} Python processes")
|
||||
else:
|
||||
print(f" ✗ Error: {result.error}")
|
||||
|
||||
# Test 9: Format code (check only)
|
||||
print("\n9. Testing format_code (check mode)...")
|
||||
result = await tools.format_code(config_file, formatter="black", check_only=True)
|
||||
test_results.append(("format_code", True)) # Success even if formatting needed
|
||||
if result.success:
|
||||
print(f" ✓ Format check completed")
|
||||
else:
|
||||
print(f" ⚠ Format issues found (expected): {result.message}")
|
||||
|
||||
# Test 10: Execute allowed command
|
||||
print("\n10. Testing execute_command...")
|
||||
result = await tools.execute_command("python --version")
|
||||
test_results.append(("execute_command", result.success))
|
||||
if result.success:
|
||||
version = result.data.get("stdout", "").strip()
|
||||
print(f" ✓ {version}")
|
||||
else:
|
||||
print(f" ✗ Error: {result.error}")
|
||||
|
||||
# Summary
|
||||
print("\n" + "="*60)
|
||||
print("📊 TEST SUMMARY")
|
||||
print("="*60)
|
||||
|
||||
passed = sum(1 for _, success in test_results if success)
|
||||
total = len(test_results)
|
||||
|
||||
for name, success in test_results:
|
||||
status = "✓ PASS" if success else "✗ FAIL"
|
||||
print(f" {status}: {name}")
|
||||
|
||||
print(f"\n Total: {passed}/{total} tests passed")
|
||||
|
||||
if passed == total:
|
||||
print("\n🎉 All tests passed! Server is ready to use.")
|
||||
return 0
|
||||
else:
|
||||
print(f"\n⚠ {total - passed} test(s) failed. Check configuration.")
|
||||
return 1
|
||||
|
||||
|
||||
async def test_tool_call_handler():
|
||||
"""Test the tool call handler directly."""
|
||||
print("\n🔧 Testing tool call handler...\n")
|
||||
|
||||
class MockServer:
|
||||
def list_tools(self):
|
||||
def decorator(func):
|
||||
return func
|
||||
return decorator
|
||||
def call_tool(self):
|
||||
def decorator(func):
|
||||
return func
|
||||
return decorator
|
||||
|
||||
tools = PythonProjectTools(MockServer())
|
||||
|
||||
# Test a simple tool call
|
||||
result = await tools.handle_tool_call(
|
||||
"get_python_env",
|
||||
{}
|
||||
)
|
||||
|
||||
if result and len(result) > 0:
|
||||
response = json.loads(result[0].text)
|
||||
if response.get("success"):
|
||||
print("✓ Tool call handler working correctly")
|
||||
return True
|
||||
else:
|
||||
print(f"✗ Tool call failed: {response.get('error')}")
|
||||
return False
|
||||
else:
|
||||
print("✗ No response from tool call handler")
|
||||
return False
|
||||
|
||||
|
||||
async def main():
|
||||
"""Main test runner."""
|
||||
print(f"🐍 MCP Python Project Manager - Test Suite")
|
||||
print(f" Workspace: {config.workspace_root}")
|
||||
print(f" Debug Mode: {config.debug_mode}")
|
||||
print(f" Python: {sys.version.split()[0]}\n")
|
||||
|
||||
# Run tool tests
|
||||
tool_test_result = await test_tools()
|
||||
|
||||
# Run handler test
|
||||
handler_result = await test_tool_call_handler()
|
||||
|
||||
# Final result
|
||||
print("\n" + "="*60)
|
||||
if tool_test_result == 0 and handler_result:
|
||||
print("✅ ALL TESTS PASSED - Server is ready!")
|
||||
return 0
|
||||
else:
|
||||
print("❌ SOME TESTS FAILED - Please check configuration")
|
||||
return 1
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
exit_code = asyncio.run(main())
|
||||
sys.exit(exit_code)
|
||||
@@ -0,0 +1,142 @@
|
||||
import os
|
||||
import sys
|
||||
import json
|
||||
import asyncio
|
||||
import platform
|
||||
import subprocess
|
||||
from typing import List, Dict, Any
|
||||
from mcp.types import Tool
|
||||
|
||||
# --- ОПРЕДЕЛЕНИЕ ИНСТРУМЕНТОВ ---
|
||||
|
||||
def get_tool_definitions() -> List[Tool]:
|
||||
return [
|
||||
Tool(
|
||||
name="run_script",
|
||||
description="Запускает Python скрипт в указанной директории.",
|
||||
inputSchema={
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"script_path": {"type": "string", "description": "Путь к скрипту (например, main.py)"},
|
||||
"working_dir": {"type": "string", "description": "Рабочая директория"}
|
||||
},
|
||||
"required": ["script_path"]
|
||||
}
|
||||
),
|
||||
Tool(
|
||||
name="install_package",
|
||||
description="Устанавливает пакет через pip.",
|
||||
inputSchema={
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"package_name": {"type": "string", "description": "Имя пакета"},
|
||||
"working_dir": {"type": "string", "description": "Директория проекта (опционально)"}
|
||||
},
|
||||
"required": ["package_name"]
|
||||
}
|
||||
),
|
||||
Tool(
|
||||
name="list_files",
|
||||
description="Выводит список файлов и папок.",
|
||||
inputSchema={
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"path": {"type": "string", "description": "Путь к папке"}
|
||||
},
|
||||
"required": ["path"]
|
||||
}
|
||||
),
|
||||
Tool(
|
||||
name="read_file",
|
||||
description="Читает содержимое текстового файла.",
|
||||
inputSchema={
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"file_path": {"type": "string", "description": "Путь к файлу"}
|
||||
},
|
||||
"required": ["file_path"]
|
||||
}
|
||||
),
|
||||
Tool(
|
||||
name="get_env_info",
|
||||
description="Информация о системе и Python окружении.",
|
||||
inputSchema={"type": "object", "properties": {}}
|
||||
)
|
||||
]
|
||||
|
||||
# --- ЛОГИКА ВЫПОЛНЕНИЯ ---
|
||||
|
||||
async def execute_tool(name: str, arguments: Dict[str, Any]) -> str:
|
||||
"""Маршрутизатор вызовов."""
|
||||
if name == "run_script":
|
||||
return await _run_script(arguments.get("script_path"), arguments.get("working_dir"))
|
||||
elif name == "install_package":
|
||||
return await _install_package(arguments.get("package_name"), arguments.get("working_dir"))
|
||||
elif name == "list_files":
|
||||
return await _list_files(arguments.get("path", "."))
|
||||
elif name == "read_file":
|
||||
return await _read_file(arguments.get("file_path"))
|
||||
elif name == "get_env_info":
|
||||
return await _get_env_info()
|
||||
else:
|
||||
return f"Ошибка: Инструмент '{name}' не найден."
|
||||
|
||||
# --- ВСПОМОГАТЕЛЬНЫЕ ФУНКЦИИ ---
|
||||
|
||||
async def _run_command(cmd: List[str], cwd: str = None) -> str:
|
||||
"""Асинхронный запуск команды."""
|
||||
try:
|
||||
process = await asyncio.create_subprocess_exec(
|
||||
*cmd,
|
||||
stdout=asyncio.subprocess.PIPE,
|
||||
stderr=asyncio.subprocess.PIPE,
|
||||
cwd=cwd
|
||||
)
|
||||
stdout, stderr = await process.communicate()
|
||||
|
||||
result = f"STDOUT:\n{stdout.decode('utf-8', errors='replace')}"
|
||||
if stderr:
|
||||
result += f"\nSTDERR:\n{stderr.decode('utf-8', errors='replace')}"
|
||||
|
||||
if process.returncode != 0:
|
||||
result += f"\n[Код завершения: {process.returncode}]"
|
||||
return result
|
||||
except Exception as e:
|
||||
return f"Ошибка выполнения команды: {e}"
|
||||
|
||||
async def _run_script(script_path: str, working_dir: str = None) -> str:
|
||||
if not working_dir:
|
||||
working_dir = os.path.dirname(script_path) or os.getcwd()
|
||||
return await _run_command([sys.executable, script_path], cwd=working_dir)
|
||||
|
||||
async def _install_package(package_name: str, working_dir: str = None) -> str:
|
||||
cmd = [sys.executable, "-m", "pip", "install", package_name]
|
||||
return await _run_command(cmd, cwd=working_dir)
|
||||
|
||||
async def _list_files(path: str) -> str:
|
||||
try:
|
||||
if not os.path.exists(path):
|
||||
return f"Путь не найден: {path}"
|
||||
items = os.listdir(path)
|
||||
files = [i for i in items if os.path.isfile(os.path.join(path, i))]
|
||||
dirs = [i + "/" for i in items if os.path.isdir(os.path.join(path, i))]
|
||||
return "Папки:\n" + "\n".join(sorted(dirs)) + "\n\nФайлы:\n" + "\n".join(sorted(files))
|
||||
except Exception as e:
|
||||
return f"Ошибка чтения: {e}"
|
||||
|
||||
async def _read_file(file_path: str) -> str:
|
||||
try:
|
||||
if not os.path.exists(file_path):
|
||||
return f"Файл не найден: {file_path}"
|
||||
with open(file_path, "r", encoding="utf-8") as f:
|
||||
return f.read()
|
||||
except Exception as e:
|
||||
return f"Ошибка чтения: {e}"
|
||||
|
||||
async def _get_env_info() -> str:
|
||||
info = {
|
||||
"os": platform.system(),
|
||||
"python": platform.python_version(),
|
||||
"cwd": os.getcwd()
|
||||
}
|
||||
return json.dumps(info, indent=2, ensure_ascii=False)
|
||||
Reference in New Issue
Block a user