Servidor MCP Brex

Un servidor de Protocolo de Contexto de Modelo (MCP) para integrarse con la API Brex, permitiendo a los agentes de IA interactuar con datos y recursos financieros.

Visión general

Este servidor MCP proporciona un puente entre los agentes de IA y la plataforma financiera Brex, permitiendo a los agentes:

• Recuperar información de cuentas y transacciones
• Acceder a datos de gastos y recibos
• Gestionar recursos presupuestarios y límites de gastos
• Ver información del equipo

El servidor implementa herramientas y gestores de recursos estandarizados siguiendo la especificación MCP, lo que permite un acceso seguro y eficiente a los datos financieros.

Características

Recursos

Recursos de cuentas

• brex://accounts - Lista de todas las cuentas
• brex://accounts/{id} - Acceso a los detalles de cuentas específicas

Recursos de gastos

• brex://expenses - Lista de todos los gastos con paginación
• brex://expenses/{id} - Acceso a detalles de gastos específicos
• brex: //expenses/card - Lista de todos los gastos de tarjeta
• brex://expenses/card/{id} - Acceso a detalles específicos de gastos de tarjeta

Nota: Los recursos de gastos amplían automáticamente la información del comerciante y del presupuesto para mostrar nombres legibles por humanos en lugar de ID.

Recursos de presupuesto

• brex://presupuestos - Lista de todos los presupuestos con paginación
• brex://presupuestos/{id} - Acceso a detalles específicos del presupuesto
• brex:/ /límites_gastos - Lista de todos los límites de gastos
• brex://spend_limits/{id} - Acceso a detalles específicos de límites de gastos
• brex://budget_programs - Lista de todos los programas presupuestarios
• brex://budget_programs/{id} - Acceso a detalles específicos del programa presupuestario

Recursos de equipo

• brex://users/me - Obtener información del usuario actual

Herramientas

Gestión de recibos

• match_receipt - Comparar un recibo con gastos existentes
• upload_receipt - Cargar un recibo para un gasto específico

Gestión de gastos

• update_expense - Actualizar los detalles de un gasto de tarjeta (nota, categoría, etc.)
• get_all_expenses - Obtener todos los gastos con opciones de filtrado e información ampliada de comerciante/presupuesto
• get_all_card_expenses - Obtener todos los gastos de tarjeta con opciones de filtrado e información ampliada de comerciante/presupuesto

Nota: Por motivos de seguridad, las herramientas que crean, actualizan o eliminan presupuestos, límites de gastos y programas de presupuesto no están implementadas en esta versión.

Instalación

Requisitos previos

• Node.js v18 o superior
• Código de acceso a la API Brex

Configurar

1. Clona este repositorio:

git clone https://github.com/dennisonbertram/brex-mcp-server.git cd brex-mcp-server

2. Instalar dependencias:

npm install

3. Cree un archivo .env con su token Brex API:

BREX_API_KEY=tu_token_aquí BREX_API_URL=https://platform.brexapis.com PORT=3000 NODE_ENV=desarrollo RATE_LIMIT_REQUESTS=1000 RATE_LIMIT_WINDOW_MS=60000 LOG_LEVEL=info

4. Construye el servidor:

npm run build

Configuración con Claude

Para utilizarlo con Claude Desktop, es necesario añadir el servidor al archivo de configuración de Claude:

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

1. Abra Claude for Desktop y vaya a la configuración haciendo clic en el menú Claude y seleccionando "Configuración..."
2. Haga clic en "Desarrollador" en la barra lateral izquierda, luego haga clic en "Editar Config"
3. Actualice el archivo de configuración con los ajustes del servidor Brex MCP:

{ "mcpServers": { "brex-server": { "command": "node", "args": [ "/path/to/brex-mcp-server/build/index.js" ], "env": { "BREX_API_KEY": "your_brex_api_key_here", "BREX_API_URL": "https://platform.brexapis.com", "PORT": "3000", "NODE_ENV": "development", "RATE_LIMIT_REQUESTS": "1000", "RATE_LIMIT_WINDOW_MS": "60000", "LOG_LEVEL": "info" } } }

Asegúrese de:

• Sustituir /path/to/brex-mcp-server por la ruta real donde instaló el servidor
• Sustituya your_brex_api_key_here por su clave Brex API real
• Utilice rutas absolutas para la ubicación del servidor

Sólo son necesarios los valores BREX_API_KEY y BREX_API_URL; las demás variables de entorno tienen valores predeterminados razonables, pero pueden personalizarse si es necesario.

4. Guarde el archivo y reinicie Claude for Desktop
5. Compruebe que el servidor funciona buscando el icono del martillo en la esquina inferior derecha del cuadro de entrada

Desarrollo

Para desarrollo con auto-rebuild:

npm run dev

Lint su código:

npm run lint

Ejecutar pruebas:

npm run test

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser un reto. Recomendamos utilizar el Inspector MCP para la depuración.

Consideraciones de seguridad

Este servidor implementa varias medidas de seguridad:

• Operaciones de sólo lectura para recursos financieros sensibles
• No almacenamiento de credenciales API en el código
• Limitación de la velocidad de las solicitudes API
• Gestión de errores y registro adecuados

Estado de la implementación

Para conocer el plan de implantación detallado y el estado de las distintas funciones, consulte documentation/implementation_plan.md.

Licencia

Este proyecto está licenciado bajo la Licencia MIT - vea el archivo LICENSE para más detalles.

Autor

Dennison Bertram - dennison@dennisonbertram.com