Content
# 🤖 Enhanced MCP Configuration for Claude Desktop
**Advanced Model Context Protocol (MCP) server configuration with intelligent usage policies, security constraints, and optimized performance settings.**
## ✨ Features
- **15 Pre-configured MCP Servers** with detailed usage policies
- **Intelligent Prompts** that guide AI behavior for each tool
- **Security-First Design** with API key protection and path restrictions
- **Performance Optimization** with resource management and caching
- **Memory Management** systems for context preservation
- **Automated Deployment** with backup and validation
## 🏗️ Architecture
### Memory & Context Systems
- **Context7**: Long conversation context preservation
- **Cognee**: Knowledge graph management and semantic analysis
- **Deebo**: Experimental AI memory bank with multi-model support
### Development Tools
- **ast-grep**: Advanced code analysis and pattern matching
- **git-mcp**: Complete Git operations with safety constraints
- **Docker**: Container management with project isolation
- **Puppeteer**: Browser automation and testing
### Data & Search
- **Brave Search**: Privacy-focused web and local search
- **Fetch**: Secure API data retrieval with rate limiting
- **GitHub**: Repository management and collaboration
### Utilities
- **Filesystem**: Secure file operations with path restrictions
- **Markdownify**: Content formatting and documentation
- **Sequential Thinking**: Complex problem-solving workflows
## 🚀 Quick Start
### 1. Prerequisites
```bash
# Required dependencies
npm install -g @modelcontextprotocol/server-filesystem
npm install -g @modelcontextprotocol/server-brave-search
npm install -g @modelcontextprotocol/server-puppeteer
npm install -g @modelcontextprotocol/server-sequential-thinking
# Docker for GitHub MCP server
docker pull ghcr.io/github/github-mcp-server
# Python UV for enhanced servers
pip install uv
```
### 2. Configuration Setup
```bash
# Backup your existing configuration
cp ~/.config/Claude\ Desktop/claude_desktop_config.json ~/.config/Claude\ Desktop/claude_desktop_config.json.backup
# Apply the enhanced configuration
cp claude_desktop_config.json ~/.config/Claude\ Desktop/claude_desktop_config.json
```
### 3. Environment Variables
Create a `.env` file with your API keys:
```bash
# Required API Keys
GITHUB_PERSONAL_ACCESS_TOKEN=your_github_token_here
BRAVE_API_KEY=your_brave_api_key_here
LLM_API_KEY=your_openai_api_key_here
OPENROUTER_API_KEY=your_openrouter_key_here
```
## 🔧 Usage Policies
Each MCP server includes intelligent usage policies:
### High Priority Servers
- **Filesystem**: All file operations with security validation
- **ast-grep**: Code analysis and refactoring
- **git-mcp**: Version control with safety checks
- **Docker**: Container management
- **Puppeteer**: Browser automation
- **Sequential Thinking**: Complex problem solving
- **GitHub**: Repository management
### Medium Priority Servers
- **Context7**: Long conversation context
- **Cognee**: Knowledge management
- **Deebo**: AI experimentation
- **Brave Search**: Information gathering
- **Fetch**: API data retrieval
- **Claude Prompts**: Task-specific guidance
### Low Priority Servers
- **Markdownify**: Content formatting
## 🔒 Security Features
### API Key Protection
- Environment variable isolation
- No hardcoded credentials in configuration
- Secure token management guidelines
### Path Restrictions
```json
"constraints": "Do not access system directories like /etc or /sys unless explicitly authorized by the user."
```
### Rate Limiting
- Configurable request limits for external APIs
- Resource usage monitoring
- Performance optimization settings
## 📊 Memory Management
### Context Preservation
- **12,000 minimum tokens** for Context7
- **Memory bank persistence** with Deebo
- **Knowledge graph storage** with Cognee
### Performance Optimization
```json
"env": {
"GITMCP_CACHE_TTL": "7200",
"GITMCP_MAX_TOKENS": "24000",
"UV_HTTP_TIMEOUT": "300",
"NODE_OPTIONS": "--max-old-space-size=2048"
}
```
## 🛠️ Customization
### Adding New Servers
1. Add server configuration to `mcpServers` object
2. Define usage policy with priority, prompt, use cases, and constraints
3. Set appropriate environment variables
4. Validate JSON structure
### Modifying Usage Policies
```json
"usagePolicy": {
"priority": "high|medium|low",
"prompt": "Detailed instructions for AI behavior",
"useCases": ["specific", "use", "cases"],
"constraints": "Security and performance limitations"
}
```
## 📋 Server Details
| Server | Priority | Primary Use Case | Key Features |
|--------|----------|------------------|--------------|
| filesystem | High | File operations | Path security, validation |
| ast-grep | High | Code analysis | Pattern matching, refactoring |
| git-mcp | High | Version control | Safety checks, detailed commits |
| puppeteer | High | Browser automation | Web testing, scraping |
| sequential-thinking | High | Problem solving | Step-by-step analysis |
| github-mcp-server | High | Repository management | Issue tracking, PRs |
| docker | High | Container management | Project isolation |
| Context7 | Medium | Context preservation | Long conversations |
| cognee | Medium | Knowledge management | Semantic analysis |
| deebo | Medium | AI experimentation | Multi-model support |
| brave-search | Medium | Information gathering | Privacy-focused search |
| fetch | Medium | API interaction | Rate limiting, caching |
| claude-prompts | Medium | Prompt engineering | Task-specific guidance |
| markdownify | Low | Content formatting | Documentation support |
## 🔧 Troubleshooting
### Common Issues
1. **Server Not Starting**: Check API keys and environment variables
2. **Permission Denied**: Verify path restrictions and user permissions
3. **Rate Limiting**: Review API usage and adjust constraints
4. **Memory Issues**: Monitor token usage and optimize settings
### Validation
```bash
# Validate JSON configuration
python3 -c "import json; json.load(open('claude_desktop_config.json')); print('✅ Valid JSON')"
# Check server count
python3 -c "import json; config=json.load(open('claude_desktop_config.json')); print(f'Servers: {len(config[\"mcpServers\"])}')"
```
## 📈 Performance Monitoring
### Resource Usage
- Monitor memory consumption with Node.js heap size limits
- Track API call frequency and costs
- Optimize cache settings for frequently accessed data
### Logging
```json
"env": {
"DEBUG": "deebo:*",
"LOG_LEVEL": "info",
"PYTHONFAULTHANDLER": "1"
}
```
## 🤝 Contributing
1. Fork the repository
2. Create a feature branch
3. Add your MCP server configuration
4. Include usage policies and security constraints
5. Test thoroughly with various scenarios
6. Submit a pull request
## 📄 License
MIT License - Feel free to use and modify for your projects.
## 🙏 Acknowledgments
- **Anthropic** for Claude Desktop and MCP framework
- **MCP Community** for server implementations
- **Open Source Contributors** for individual MCP servers
---
**Built with ❤️ for the Claude Desktop community**
> This configuration was autonomously developed and deployed using advanced AI code generation and system automation.
