DEMO Country MCP Server

DEMO Country MCP Server

Um servidor MCP modular que expõe ferramentas para consultas de países e estados. Pronto para uso como CLI ou agente plug-in.

---

Início Rápido

1. Clone e configure seu ambiente

   git clone <REPO_URL> cd mcp-server

2. Compile o pacote

   python -m build

3. Instale globalmente com pipx

   pipx install dist/country_mcp_server-*.whl --force

4. Execute o servidor

   country-mcp-server

   Ou, para desenvolvimento com a UI do Inspector:

   mcp dev country_server_mcp/main.py

---

Adicione Suas Próprias Ferramentas

• Coloque novos módulos em country_server_mcp/tools/.
• Cada módulo deve definir uma função register(mcp) e adicionar ferramentas usando @mcp.tool().
• Importe e chame o register(mcp) de cada nova ferramenta em main.py.
• Recompile e reinstale com pipx install dist/… --force.

---

Exemplo de Estrutura de Projeto

country_server_mcp/
    __init__.py
    main.py
    tools/
        __init__.py
        countries.py
        states.py
pyproject.toml
README.md

---

Use como um agente MCP

Adicione à configuração do seu orquestrador:

{
  "mcpServers": {
    "country": {
      "command": "country-mcp-server",
      "args": []
    }
  }
}

---

Notas

• Se você atualizar as ferramentas, recompile e reinstale o pacote.
• Certifique-se de que seu binário CLI esteja no seu PATH (~/.local/bin para pipx por padrão).
• Para o modo de desenvolvimento, instalação editável: pip install -e .

---

Deixe-me saber se você quer uma versão ainda mais minimalista ou precisa de uma descrição específica de “primeiros passos” para uma equipe!