MCP Servers Collection

MCP Servers Collection

Uma coleção de servidores Model Context Protocol (MCP) para aprimorar as capacidades de ferramentas de IA. Esses servidores fornecem interfaces estruturadas para assistentes de IA interagirem com diversas ferramentas e serviços de desenvolvimento.

O que é MCP?

O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA se conectem com segurança a fontes de dados e ferramentas externas. Os servidores MCP expõem funcionalidades específicas como ferramentas que os assistentes de IA podem descobrir e utilizar.

Servidores Disponíveis

🔄 Servidor Overmind

Caminho: overmind/
Propósito: Gerenciamento de processos para aplicações baseadas em Procfile usando Overmind

Instalação:

uvx --from git+https://github.com/geoffjay/mcp-servers#subdirectory=overmind mcp-server-overmind

📈 Servidor de Análise Fundamental

Caminho: fundamental_analysis/ Propósito: Realiza análise fundamental para um código de ação específico usando a API Finnhub.

Instalação:

uvx --from git+https://github.com/geoffjay/mcp-servers#subdirectory=fundamental_analysis mcp-server-fundamental-analysis

Principais Recursos:

• Iniciar, parar e reiniciar processos definidos em Procfiles
• Monitorar o status e a saúde dos processos
• Executar comandos no ambiente Overmind
• Detecção de instâncias em execução baseada em sockets
• Suporte para locais e formações personalizadas de Procfile

Ferramentas Disponíveis:

• overmind_start - Iniciar o Overmind com configuração opcional
• overmind_stop - Parar processos específicos ou todos os processos
• overmind_restart - Reiniciar processos especificados
• overmind_status - Obter o status de todos os processos
• overmind_quit - Encerrar o Overmind de forma graciosa
• overmind_kill - Forçar a finalização de todos os processos
• overmind_run - Executar comandos no ambiente Overmind
• overmind_connect - Obter instruções de conexão para processos
• overmind_is_running - Verificar se o Overmind está em execução
• overmind_check_procfile - Validar a existência e o conteúdo do Procfile
• overmind_find_procfiles - Encontrar todos os Procfiles em uma árvore de diretórios

Requisitos: Overmind e tmux devem estar instalados no sistema.

Testes: O diretório overmind/test_environment/ contém uma configuração de teste completa com processos de exemplo e utilitários de teste. Execute ./overmind/test_environment/run_tests.sh para testes abrangentes.

Início Rápido

Usando com o Claude Desktop

Adicione qualquer um desses servidores à sua configuração do Claude Desktop:

{
  "mcpServers": {
    "overmind": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/geoffjay/mcp-servers#subdirectory=overmind",
        "mcp-server-overmind"
      ]
    }
  }
}

Usando com Outros Clientes MCP

Cada servidor pode ser executado diretamente:

# Overmind server
uvx --from git+https://github.com/geoffjay/mcp-servers#subdirectory=overmind mcp-server-overmind

Desenvolvimento

Pré-requisitos

• Python 3.10 ou superior
• uv para gerenciamento de dependências
• direnv (opcional, para ativação automática do ambiente)

Estrutura do Projeto

mcp-servers/
├── README.md                 # This file
├── overmind/                 # Overmind process manager server
│   ├── src/mcp_server_overmind/
│   ├── tests/
│   ├── pyproject.toml
│   ├── .envrc
│   └── README.md
└── [future-servers]/         # Additional servers will be added here

Adicionando um Novo Servidor

1. Crie um novo diretório para o seu servidor
2. Configure a estrutura do projeto:

   your-server/
   ├── src/mcp_server_yourname/
   │   ├── __init__.py
   │   └── server.py
   ├── tests/
   ├── pyproject.toml
   ├── .envrc
   └── README.md
   

3. Configure pyproject.toml com:
   • Nome do pacote: mcp-server-yourname
   • Ponto de entrada: mcp-server-yourname = "mcp_server_yourname.server:main"
   • Dependências incluindo mcp>=1.2.0
4. Implemente seu servidor usando o framework FastMCP
5. Adicione testes abrangentes
6. Documente seu servidor no README.md dele
7. Atualize este README.md principal para incluir seu servidor

Executando Testes

Cada servidor inclui seu próprio conjunto de testes:

cd your-server-directory
uv run --extra dev pytest tests/ -v

Compilando e Testando Localmente

cd your-server-directory
uv build
uv run your-entry-point

Contribuindo

Aceitamos contribuições! Por favor:

1. Siga a estrutura e os padrões existentes do projeto
2. Inclua testes abrangentes para novas funcionalidades
3. Adicione documentação completa
4. Garanta que seu servidor siga as melhores práticas do MCP
5. Atualize este README ao adicionar novos servidores

Estilo de Código

• Use dicas de tipo do Python em todo o código
• Siga padrões async/await para operações de I/O
• Inclua docstrings para todas as funções públicas
• Use nomes de ferramentas descritivos e documentação clara de parâmetros

Requisitos de Teste

• Alcance alta cobertura de testes (objetivo de >90%)
• Inclua testes de unidade e integração
• Simule dependências externas adequadamente
• Teste cenários de sucesso e falha

Licença

Este projeto é licenciado sob a Licença MIT. Consulte os diretórios individuais dos servidores para informações específicas de licença.

Recursos

• Documentação do Model Context Protocol
• SDK Python do MCP
• Framework FastMCP
• Guia MCP do Claude Desktop

Suporte

Para problemas com servidores específicos, consulte os arquivos README individuais deles. Para problemas ou perguntas gerais do projeto, abra uma issue neste repositório.

---

Status dos Servidores

Servidor	Status	Versão	Última Atualização
overmind	✅ Estável	0.1.0	Janeiro 2025
fundamental_analysis	✅ Estável	0.1.0	Janeiro 2025

Roadmap

Futuros servidores em consideração:

• Configuração de ambiente de desenvolvimento
• Processamento de áudio (MIDI/OSC)