Metadata-Version: 2.4
Name: mcp-config-tool
Version: 0.1.2
Summary: A CLI tool to configure MCP servers for various clients like Claude Desktop and VSCode
Author-email: Marcus Jellinghaus <Marcus@Jellinghaus.ch>
Maintainer-email: Marcus Jellinghaus <Marcus@Jellinghaus.ch>
License: MIT
Project-URL: Homepage, https://github.com/MarcusJellinghaus/mcp-config
Project-URL: Repository, https://github.com/MarcusJellinghaus/mcp-config
Project-URL: Bug Tracker, https://github.com/MarcusJellinghaus/mcp-config/issues
Project-URL: Documentation, https://github.com/MarcusJellinghaus/mcp-config#readme
Keywords: mcp,configuration,claude,vscode,ai,cli
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Installation/Setup
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pathspec>=0.12.1
Requires-Dist: mcp[cli,server]>=1.3.0
Requires-Dist: structlog>=24.5.0
Requires-Dist: python-json-logger>=3.2.1
Provides-Extra: dev
Requires-Dist: black>=24.10.0; extra == "dev"
Requires-Dist: isort>=5.13.2; extra == "dev"
Requires-Dist: pylint>=3.3.3; extra == "dev"
Requires-Dist: pytest>=8.3.5; extra == "dev"
Requires-Dist: pytest-json-report>=1.5.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.25.3; extra == "dev"
Requires-Dist: mypy>=1.9.0; extra == "dev"
Dynamic: license-file

# MCP Config

Configure MCP servers for Claude Desktop, VSCode, and IntelliJ with one command.

## Quick Start

```bash
# Install
pip install git+https://github.com/MarcusJellinghaus/mcp-config.git

# Setup for Claude Desktop
mcp-config setup mcp-code-checker "My Project" --project-dir .

# Setup for Claude Code (project-level)
mcp-config setup mcp-code-checker "My Project" --client claude-code --project-dir .

# Setup for VSCode (team projects)
mcp-config setup mcp-code-checker "My Project" --client vscode-workspace --project-dir .

# Setup for IntelliJ/PyCharm (GitHub Copilot)
mcp-config setup mcp-code-checker "My Project" --client intellij --project-dir .

# Setup filesystem server with reference projects
mcp-config setup mcp-server-filesystem "My Files" --project-dir . \
  --reference-project docs=/path/to/docs \
  --reference-project examples=/path/to/examples
```

## Built-in Help System

Get comprehensive help directly from the CLI:

```bash
# Tool overview and commands
mcp-config help

# Help for specific commands
mcp-config help setup
mcp-config help remove
mcp-config help list
mcp-config help validate

# Help for server parameters
mcp-config help mcp-code-checker
mcp-config help mcp-server-filesystem

# Quick reference
mcp-config help mcp-code-checker --quick
```

## Supported MCP Servers

- **mcp-code-checker** - Code analysis using pylint, pytest, and mypy
- **mcp-server-filesystem** - File system operations
- External servers via Python entry points

## Documentation

- **[USER_GUIDE.md](USER_GUIDE.md)** - Complete user documentation
- **[CONTRIBUTING.md](CONTRIBUTING.md)** - For developers enhancing mcp-config

## Supported Clients

- **Claude Desktop** - claude_desktop_config.json (user-level)
- **Claude Code** - .mcp.json (project-level)
- **VSCode** - .vscode/mcp.json  
- **IntelliJ/PyCharm** - GitHub Copilot mcp.json

## Features

- 🔧 **Multi-Client**: Works with Claude Desktop, VSCode, and IntelliJ
- 🚀 **Cross-Platform**: Windows, macOS, and Linux support
- 📝 **Simple**: Standard JSON configuration
- Auto-detects Python environments and virtual environments
- Backs up configurations before changes
- Validates server setup with comprehensive checks
- Extensive CLI help system

## License

MIT - see [LICENSE](LICENSE) file.
