MCP Server Toolkit

Um kit de ferramentas abrangente para desenvolver, testar e implantar servidores Model Context Protocol (MCP).

GitHubExperimente este MCPPatrocinado

Documentação

MCP Server Toolkit

Um kit de ferramentas abrangente para desenvolver, testar e implantar servidores Model Context Protocol (MCP).

🚀 Visão Geral

Este repositório fornece um ambiente estruturado para criar servidores MCP prontos para produção, com frameworks de teste integrados, modelos e documentação.

📁 Estrutura de Diretórios

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

🏗️ Servidores Disponíveis

AppleScript MCP Server

Execute comandos AppleScript por meio do protocolo MCP. Permite interação com aplicativos macOS e recursos do sistema.

  • Localização: servers/applescript/
  • Linguagens: Implementações em Node.js e Python
  • Documentação: docs/guides/applescript-permissions-guide.md

🧪 Testes

Execute testes para todos os servidores:

cd testing/framework
node test-runner.js

Execute testes para um servidor específico:

cd testing/suites/applescript
./permissions-check.sh

📝 Criando um Novo Servidor MCP

  1. Escolha um modelo de templates/
  2. Copie para development/ para o trabalho inicial
  3. Siga o README do modelo para a configuração
  4. Mova para servers/ quando estiver pronto para produção

🔧 Configuração Global

Adicione ao seu ~/.claude/claude_config.json:

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

📚 Documentação

🤝 Contribuindo

  1. Desenvolva novos servidores em development/
  2. Escreva testes abrangentes em testing/suites/
  3. Documente em docs/
  4. Envie um PR quando estiver pronto para servers/

📄 Licença

Servidores individuais podem ter suas próprias licenças. Consulte o diretório de cada servidor para obter detalhes.