Servidor MCP em Python

Projeto base de um servidor MCP (Model Context Protocol) em Python, pronto para conectar em clientes MCP.

Requisitos

• Python 3.10+

Instalar

python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Executar

mcp-server-python

Ou usando o utilitario solicitado:

mcpserver

O servidor sobe em modo stdio, que e o formato mais comum para integrar com clientes MCP locais.

Configurar cliente MCP

VS Code

1. Copie examples/vscode.mcp.example.json para .vscode/mcp.json.

2. Se necessario, ajuste command para o Python da sua venv.

3. Reinicie o cliente MCP no VS Code.

Exemplo:

{
	"servers": {
		"python-mcp-server": {
			"type": "stdio",
			"command": "${workspaceFolder}/.venv/bin/python",
			"args": ["-m", "mcp_server"]
		}
	}
}

Claude Desktop

1. Abra o arquivo de configuracao do Claude Desktop.

2. Copie o conteudo de examples/claude_desktop_config.example.json.

3. Troque /CAMINHO/ABSOLUTO/PARA/... pelo caminho real do projeto.

Exemplo:

{
	"mcpServers": {
		"python-mcp-server": {
			"command": "/CAMINHO/ABSOLUTO/PARA/mcp_server/.venv/bin/python",
			"args": ["-m", "mcp_server"]
		}
	}
}

Tools disponiveis

• ping() -> str

• soma(a: float, b: float) -> float

• agora() -> str

• inverter_lista(itens: list[str]) -> list[str]

• buscar_jurisprudencia(consulta: str, tribunal: str | None = None, limite: int = 10) -> dict

• detalhe_jurisprudencia(url_ou_urn: str) -> dict

• buscar_jurisprudencia_avancada(consulta: str, tribunal: str | None = None, orgao: str | None = None, data_inicio: str | None = None, data_fim: str | None = None, limite: int = 5) -> dict

Jurisprudencia com dados abertos

O servidor inclui um modulo para consulta de jurisprudencia em fonte aberta via LexML Brasil.

Fluxo recomendado

1. Use buscar_jurisprudencia com termos como icms creditamento, dano moral consumidor, prisao preventiva.

2. Pegue a url ou urn de um resultado.

3. Use detalhe_jurisprudencia para obter metadados e ementa.

Exemplos de parametros:

• buscar_jurisprudencia(consulta="icms energia", tribunal="stj", limite=5)

• detalhe_jurisprudencia(url_ou_urn="urn:lex:br:superior.tribunal.justica;turma.1:acordao;resp:2006-03-09;601056-676848")

Busca avancada para analise

Use buscar_jurisprudencia_avancada quando quiser:

• recorte por periodo (data_inicio e data_fim)

• filtro de orgao (turma, secao, pleno, camara, carf)

• retorno com resumo_prompt pronto para colar em um modelo e pedir analise comparativa

Exemplo:

• buscar_jurisprudencia_avancada(consulta="icms creditamento energia", tribunal="stj", orgao="turma", data_inicio="2015-01-01", data_fim="2024-12-31", limite=3)

Estrutura

• src/mcp_server/server.py: definicao do servidor e tools.

• src/mcp_server/legal_open_data.py: integracao com dados juridicos abertos.

• src/mcp_server/__main__.py: ponto de entrada para execucao.

• pyproject.toml: metadados, dependencias e script CLI.