MCP Tool Kit

MCP Tool Kit

Um kit de ferramentas abrangente para o Model Context Protocol (MCP) com descoberta automática de ferramentas e múltiplas opções de transporte.

📚 Documentação Oficial | 🌐 Site | 💬 Comunidade

🚀 Construído por UsefulAI | 📖 Do GitHub ao Sucesso Comercial

🚀 Instalação Rápida - Sem Necessidade de Git!

Escolha sua plataforma e execute UM comando:

🖥️ Windows (PowerShell)

irm https://raw.githubusercontent.com/getfounded/mcp-tool-kit/main/install.ps1 | iex

🍎 macOS (Terminal)

bash <(curl -s https://raw.githubusercontent.com/getfounded/mcp-tool-kit/main/install.sh)

🐧 Linux (Terminal)

bash <(wget -qO- https://raw.githubusercontent.com/getfounded/mcp-tool-kit/main/install.sh)

É isso! O instalador irá:

• ✅ Baixar o MCP Tool Kit (sem precisar de Git!)
• ✅ Verificar o Docker (ajuda a instalar se estiver ausente)
• ✅ Criar atalhos na área de trabalho
• ✅ Configurar tudo automaticamente

📦 Métodos Alternativos de Instalação

docker run -it --name mcp-toolkit ghcr.io/getfounded/mcp-tool-kit:latest

🔧 Recursos

Registro Dinâmico de Ferramentas

As ferramentas são descobertas e registradas automaticamente em tempo de execução - nenhuma configuração manual é necessária!

Múltiplas Opções de Transporte

• stdio: Para integração com Claude Desktop
• SSE (Server-Sent Events): Para acesso baseado na web

Mais de 120 Ferramentas Disponíveis

• 📁 Sistema de Arquivos: Leia, escreva e gerencie arquivos
• 🕐 Ferramentas de Tempo: Conversões de fuso horário e operações de tempo
• 🌐 Pesquisa na Web: Integração com Brave Search
• 🤖 Automação de Navegador: Controle de navegador baseado em Playwright
• 📊 Análise de Dados: Dados do Yahoo Finance, FRED, Banco Mundial
• 📄 Ferramentas de Documentos: Manipulação de PDF, Excel, PowerPoint
• 🎯 E muito mais!

Configuração Fácil

Controle tudo através de um simples arquivo config.yaml:

enabled_tools:
  filesystem: true
  time_tools: true
  brave_search: true
  # ... more tools

tool_config:
  filesystem:
    allowed_directories: ["~/Documents", "~/Downloads"]
  brave_search:
    max_results: 10

📋 Configuração do Ambiente

1. Copie .env.template para .env
2. Adicione suas chaves de API:

   BRAVE_SEARCH_API_KEY=your_key_here
   NEWS_API_KEY=your_key_here
   FRED_API_KEY=your_key_here
   # ... other keys
   

💾 Configuração de Armazenamento

O MCP Tool Kit usa um diretório de armazenamento dedicado para operações de arquivo:

• Windows: C:\Users\{Username}\mcp-tool-kit-storage
• Mac/Linux: ~/mcp-tool-kit-storage

Configuração Automática

O diretório de armazenamento é criado automaticamente quando você executa o contêiner Docker pela primeira vez. Você também pode configurá-lo manualmente:

Windows (PowerShell):

.\scripts\setup-storage.ps1

Mac/Linux:

./scripts/setup-storage.sh

Estrutura de Armazenamento

mcp-tool-kit-storage/
├── documents/     # For document files
├── downloads/     # For downloaded files
└── workspace/     # For temporary work files

Todas as operações de arquivo através da ferramenta de sistema de arquivos serão restritas a este diretório por segurança.

🔌 Conectando ao Claude Desktop

1. Inicie o servidor no modo stdio usando o lançador
2. Adicione à configuração do Claude Desktop:

   {
     "mcpServers": {
       "mcp-tool-kit": {
         "command": "docker",
         "args": ["exec", "-i", "mcp-server", "python", "mcp_server_v2.py"]
       }
     }
   }
   

🌐 Usando o Modo SSE

1. Inicie o servidor no modo SSE usando o lançador
2. Acesse o servidor em http://localhost:8080
3. Use os endpoints SSE:
   • /sse - Fluxo de Server-Sent Events
   • /messages - Envie mensagens para o servidor

🛠️ Criando Ferramentas Personalizadas

As ferramentas agora usam um sistema de classe base padronizado:

from app.tools.base_tool import BaseTool

class MyCustomTool(BaseTool):
    def get_name(self) -> str:
        return "My Custom Tool"
        
    def get_tools(self) -> Dict[str, Callable]:
        return {
            "my_function": self.my_function
        }
        
    async def my_function(self, param: str, ctx: Context = None) -> str:
        return f"Processed: {param}"

Consulte a documentação para desenvolvedores para guias detalhados.

📚 Documentação

A documentação completa está disponível em https://docs.mcp-tool-kit.com.

Para executar a documentação localmente:

1. cd docs
2. npm install
3. npm start

🐳 Comandos Docker

Usando o Lançador (Recomendado)

Os scripts do lançador lidam com todas as operações Docker automaticamente.

Comandos Manuais

# Start server
docker-compose up -d

# View logs
docker-compose logs -f

# Stop server
docker-compose down

# Rebuild after changes
docker-compose build --no-cache

🤝 Contribuindo

1. Faça um fork do repositório
2. Crie sua branch de recurso
3. Adicione sua ferramenta a app/tools/
4. Envie um pull request

📄 Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

🆘 Suporte

• GitHub Issues
• Documentação
• Comunidade Discord (em breve)