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:

cd testing/framework
node test-runner.js

Run tests for a specific server:

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`:

{
  "mcpServers": {
    "applescript": {
      "command": "node",
      "args": ["/path/to/mcp-server-toolkit/servers/applescript/server.js"]
    }
  }
}

📚 Documentation

• AppleScript Permissions Guide
• MCP Setup Guide

🤝 Contributing

1. Develop new servers in `development/`

2. Write comprehensive tests in `testing/suites/`

3. Document in `docs/`

4. Submit PR when ready for `servers/`

📄 License

Individual servers may have their own licenses. See each server's directory for details.