Python Local

Servidor MCP python_local

Um servidor MCP que fornece um ambiente interativo de REPL (Read-Eval-Print Loop) em Python.

Componentes

Recursos

O servidor fornece acesso ao histórico das sessões REPL:

• Esquema de URI personalizado repl:// para acessar o histórico das sessões
• O histórico de cada sessão pode ser visualizado como um recurso text/plain
• O histórico mostra o código de entrada e a saída correspondente para cada execução

Ferramentas

O servidor implementa uma ferramenta:

• python_repl: Executa código Python em uma sessão persistente
  • Recebe code (código Python a ser executado) e session_id como argumentos obrigatórios
  • Mantém estado separado para cada sessão
  • Suporta expressões e declarações
  • Captura e retorna a saída de stdout/stderr

Configuração

Instalação

Claude Desktop

No MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json No Windows: %APPDATA%/Claude/claude_desktop_config.json

Configuração de Servidores Não Publicados em Desenvolvimento

```json "mcpServers": { "python_local": { "command": "uv", "args": [ "--directory", "/path/to/python_local", "run", "python_local" ] } } ```

Configuração de Servidores Publicados

```json "mcpServers": { "python_local": { "command": "uvx", "args": [ "python_local" ] } } ```

Desenvolvimento

Compilação e Publicação

Para preparar o pacote para distribuição:

1. Sincronize as dependências e atualize o arquivo de bloqueio:

uv sync

2. Compile as distribuições do pacote:

uv build

Isso criará distribuições de origem e wheel no diretório dist/.

3. Publique no PyPI:

uv publish

Observação: Você precisará definir as credenciais do PyPI por meio de variáveis de ambiente ou flags de comando:

• Token: --token ou UV_PUBLISH_TOKEN
• Ou nome de usuário/senha: --username/UV_PUBLISH_USERNAME e --password/UV_PUBLISH_PASSWORD

Depuração

Como os servidores MCP são executados via stdio, a depuração pode ser desafiadora. Para a melhor experiência de depuração, recomendamos fortemente o uso do MCP Inspector.

Você pode iniciar o MCP Inspector via npm com este comando:

npx @modelcontextprotocol/inspector uv --directory /path/to/python_local run python-local

Ao iniciar, o Inspector exibirá uma URL que você pode acessar no seu navegador para começar a depurar.