MCP Server Toolkit
A comprehensive toolkit for developing, testing, and deploying Model Context Protocol (MCP) servers.
🚀 Overview
This repository provides a structured environment for creating production-ready MCP servers with built-in testing frameworks, templates, and documentation.
📁 Directory Structure```
mcp-server-toolkit/
├── servers/ # Production-ready MCP servers
│ └── applescript/ # AppleScript execution server
├── testing/ # Centralized testing framework
│ ├── framework/ # Core test utilities
│ ├── suites/ # Test suites per server
│ └── results/ # Test results (gitignored)
├── development/ # Active development/prototypes
├── templates/ # Boilerplate for new servers
│ ├── node-mcp-template/ # Node.js server template
│ └── python-mcp-template/ # Python server template
├── docs/ # Documentation
│ ├── guides/ # How-to guides
│ └── api/ # API documentation
├── tools/ # Development utilities
└── _archive/ # Archived/deprecated items
## 🏗️ Available Servers
### AppleScript MCP Server
Execute AppleScript commands through the MCP protocol. Enables interaction with macOS applications and system features.
- **Location**: `servers/applescript/`
- **Languages**: Node.js & Python implementations
- **Documentation**: `docs/guides/applescript-permissions-guide.md`
## 🧪 Testing
Run tests for all servers:```bash
cd testing/framework
node test-runner.js
Run tests for a specific server:```bash
cd testing/suites/applescript
./permissions-check.sh
## 📝 Creating a New MCP Server
1. Choose a template from `templates/`
2. Copy to `development/` for initial work
3. Follow the template README for setup
4. Move to `servers/` when production-ready
## 🔧 Global Configuration
Add to your `~/.claude/claude_config.json`:```json
{
"mcpServers": {
"applescript": {
"command": "node",
"args": ["/path/to/mcp-server-toolkit/servers/applescript/server.js"]
}
}
}
📚 Documentation
- AppleScript Permissions Guide
- MCP Setup Guide
🤝 Contributing
- Develop new servers in
development/ - Write comprehensive tests in
testing/suites/ - Document in
docs/ - Submit PR when ready for
servers/
📄 License
Individual servers may have their own licenses. See each server's directory for details.
