Brev

Servidor MCP Brev

Esta é uma implementação de servidor MCP para a Brev.

Configuração

O servidor MCP usa o token de acesso da API da CLI da Brev e a org atualmente definida.

Siga a documentação da Brev para baixar a CLI e fazer login, caso ainda não tenha feito.

Se quiser alternar sua org Brev, execute brev set <org-name>

O token de acesso da CLI expira a cada hora. Se você tiver quaisquer erros 403, basta executar brev ls para atualizar o token de acesso.

Início rápido

Configurar o repositório localmente

git clone git@github.com:brevdev/brev-mcp.git

Instalar o uv

Siga o guia de instalação do uv

Claude Desktop

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

Adicione o seguinte ao seu claude_desktop_config.json:

"mcpServers": {
  "brev_mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "<path-to-repo>",
      "run",
      "brev-mcp"
    ]
  }
}

Desenvolvimento

Build e Publicação

Para preparar o pacote para distribuição:

1. Sincronize as dependências e atualize o lockfile:

uv sync

2. Gere as distribuições do pacote:

uv build

Isso criará distribuições de código-fonte 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 /Users/tmontfort/Brev/repos/brev_mcp run brev-mcp

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