# 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](docs/guides/applescript-permissions-guide.md)
- [MCP Setup Guide](docs/guides/applescript-mcp-setup-summary.md)

## 🤝 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.