Brev

Servidor MCP de Brev

Esta es una implementación del servidor MCP para Brev.

Configuración

El servidor MCP utiliza el token de acceso a la API de la CLI de Brev y la organización actualmente configurada.

Sigue la documentación de Brev para descargar la CLI e iniciar sesión si aún no lo has hecho.

Si deseas cambiar tu organización de Brev, ejecuta brev set <org-name>

El token de acceso de la CLI expira cada hora. Si tienes algún error 403, simplemente ejecuta brev ls para actualizar el token de acceso.

Inicio rápido

Configurar el repositorio localmente

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

Instalar uv

Sigue la guía de instalación de uv

Claude Desktop

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

Agrega lo siguiente a tu claude_desktop_config.json:

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

Desarrollo

Compilación y publicación

Para preparar el paquete para su distribución:

1. Sincroniza las dependencias y actualiza el archivo de bloqueo:

uv sync

2. Compila las distribuciones del paquete:

uv build

Esto creará distribuciones de código fuente y wheel en el directorio dist/.

3. Publica en PyPI:

uv publish

Nota: Necesitarás configurar las credenciales de PyPI mediante variables de entorno o banderas de comando:

• Token: --token o UV_PUBLISH_TOKEN
• O nombre de usuario/contraseña: --username/UV_PUBLISH_USERNAME y --password/UV_PUBLISH_PASSWORD

Depuración

Dado que los servidores MCP se ejecutan a través de stdio, la depuración puede ser un desafío. Para una mejor experiencia de depuración, recomendamos encarecidamente usar el Inspector MCP.

Puedes iniciar el Inspector MCP a través de npm con este comando:

npx @modelcontextprotocol/inspector uv --directory /Users/tmontfort/Brev/repos/brev_mcp run brev-mcp

Al iniciarlo, el Inspector mostrará una URL a la que puedes acceder en tu navegador para comenzar a depurar.