This project provides a powerful interface between Claude and your local machine, allowing Claude to execute commands, manage files, and analyze code on your behalf.
ClaudeDesktopCommander/
├── mcp-core/ # Core MCP server functionality
│ ├── src/ # TypeScript source files
│ ├── dist/ # Compiled JavaScript files
│ ├── scripts/ # Utility scripts
│ ├── logs/ # Log files
│ ├── package.json # Core dependencies
│ ├── tsconfig.json # TypeScript configuration
│ └── run-desktop-commander.bat # Launch script for core MCP
│
├── code-analyzer/ # Code analysis component
│ ├── src/ # TypeScript source files
│ ├── scripts/ # Analyzer-specific scripts
│ ├── package.json # Code analyzer dependencies
│ └── tsconfig.json # TypeScript configuration
│
├── ollama-wrapper/ # Ollama API integration
│ ├── src/ # JavaScript source files
│ ├── models/ # Ollama model configurations
│ ├── package.json # Ollama wrapper dependencies
│ ├── run-ollama-api.bat # Windows launch script
│ └── run-ollama-api.sh # Linux/macOS launch script
│
├── docs/ # Documentation
│ ├── general/ # General documentation
│ ├── mcp-core/ # MCP Core documentation
│ ├── code-analyzer/ # Code Analyzer documentation
│ └── testing/ # Testing documentation
│
├── scripts/ # Shared scripts
│ ├── setup/ # Setup scripts
│ ├── utilities/ # Utility scripts
│ └── ci/ # CI/CD scripts
│
├── docker/ # Docker configuration
│ ├── docker-compose.yml # Docker Compose configuration
│ └── Dockerfile # Docker image definition
│
├── _archive/ # Archived temporary files and obsolete components
│
├── assets/ # Shared assets and resources
├── package.json # Workspace/monorepo configuration
├── run-desktop-commander.bat # Main launcher (points to mcp-core)
└── .gitignore # Git ignore configuration
This is the core Claude Desktop Commander MCP server that handles:
- Command execution
- File operations
- Process management
- Terminal operations
A separate component for code analysis that includes:
- File scanning and chunking
- LLM-based code analysis
- Vector database integration
- Embedding generation
A component for integrating with Ollama's API:
- Ollama model management
- Inference API integration
- Model configuration
# Install dependencies for all components
npm run install:all
# Build the MCP core server
npm run build:mcp
Use the main launcher script in the root directory:
run-desktop-commander.bat
# Build the code analyzer
npm run build:analyzer
For Windows:
cd ollama-wrapper
run-ollama-api.bat
For Linux/macOS:
cd ollama-wrapper
./run-ollama-api.sh
Update your Claude Desktop configuration to point to the main run-desktop-commander.bat
file:
"desktopCommander": {
"command": "L:\\ClaudeDesktopCommander\\run-desktop-commander.bat",
"args": []
}
Detailed documentation is available in the docs/
directory:
- MCP Tools Inventory: Complete list of available tools
- MCP Setup Guide: Setup instructions for MCP servers
- Code Analyzer Setup: Setup guide for the code analyzer
- Documentation Hub: Central hub for all documentation
Each component can now be developed, tested, and versioned independently. The modular structure allows for:
- Independent dependency management
- Clearer separation of concerns
- Targeted testing and development
- Easier maintenance and extension