Servidor MCP por Reynaldo Vieira

Este repositório contém uma implementação de um servidor de Protocolo de Contexto de Modelo (MCP) para fins educacionais e de demonstração, criado por Reynaldo Vieira. Este código demonstra como construir um servidor MCP funcional que pode se integrar a vários clientes LLM.

Principais Benefícios

• Uma lista crescente de integrações pré-construídas que seu LLM pode conectar diretamente

• Flexibilidade para alternar entre provedores e fornecedores de LLM

• Melhores práticas para proteger seus dados em sua infraestrutura

Visão Geral da Arquitetura

O MCP segue uma arquitetura cliente-servidor, onde uma aplicação hospedeira pode se conectar a vários servidores:

• Hospedeiros MCP: Programas como Claude Desktop, IDEs ou ferramentas de IA que desejam acessar dados através do MCP

• Clientes MCP: Clientes de protocolo que mantêm conexões 1:1 com os servidores

• Servidores MCP: Programas leves que expõem capacidades específicas através do Protocolo de Contexto de Modelo padronizado

• Fontes de Dados: Serviços locais (arquivos, bancos de dados) e remotos (APIs) que os servidores MCP podem acessar

Conceitos Centrais do MCP

Os servidores MCP podem fornecer três tipos principais de capacidades:

• Recursos: Dados semelhantes a arquivos que podem ser lidos por clientes (como respostas de API ou conteúdo de arquivos)

• Ferramentas: Funções que podem ser chamadas pelo LLM (com a aprovação do usuário)

• Prompts: Modelos pré-escritos que ajudam os usuários a realizar tarefas específicas

Requisitos do Sistema

• Python 3.10 ou superior

• MCP SDK 1.2.0 ou superior

• Gerenciador de pacotes uv

Começando

Instalando o gerenciador de pacotes uv

No MacOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Certifique-se de reiniciar seu terminal para garantir que o comando uv seja reconhecido.

Configuração do Projeto

1. Crie e inicialize o projeto:

# Crie um novo diretório para o nosso projeto
uv init mcp-server
cd mcp-server

# Crie e ative o ambiente virtual
uv venv
source .venv/bin/activate  # No Windows, use: .venv\Scripts\activate

# Instale as dependências
uv add "mcp[cli]" httpx

2. Crie o arquivo de implementação do servidor:

touch main.py

Executando o Servidor

1. Inicie o servidor MCP:

uv run main.py

2. O servidor será iniciado e estará pronto para aceitar conexões.

Conectando ao Claude Desktop

1. Instale o Claude Desktop a partir do site oficial.

2. Configure o Claude Desktop para usar seu servidor MCP:

Edite ~/Library/Application Support/Claude/claude_desktop_config.json:

{
    "mcpServers": {
        "mcp-server-reynaldo": {
            "command": "uv",  # É melhor usar o caminho absoluto para o comando uv
            "args": [
                "--directory",
                "/CAMINHO/ABSOLUTO/PARA/SEU/mcp-server",
                "run",
                "main.py"
            ]
        }
    }
}

3. Reinicie o Claude Desktop.

Solução de Problemas

Se o seu servidor não estiver sendo reconhecido pelo Claude Desktop:

1. Verifique o caminho e as permissões do arquivo de configuração.

2. Verifique se o caminho absoluto na configuração está correto.

3. Certifique-se de que o uv está instalado corretamente e acessível.

4. Verifique os logs do Claude Desktop para mensagens de erro.

Licença

Este projeto está licenciado sob a Licença MIT. Veja o arquivo LICENSE para mais detalhes.