MCP Server Toolkit

A comprehensive toolkit for developing, testing, and deploying Model Context Protocol (MCP) servers.

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

🀝 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.

Related Servers