Cycleo MCP server

Adaptador MCP distribuible y de solo lectura para Cycleo. El servidor expone una pequeña superficie de herramientas en lista de permitidos y llama a la API JSON versionada de Cycleo con el token de portador OAuth con ámbito de usuario.

Este repositorio contiene únicamente el servidor de recursos MCP. Cycleo sigue siendo el servidor de autorización y el propietario de los datos; la integración /oauth/* está documentada en docs/auth-integration.md y debe configurarse antes del uso en producción.

Ejecución local

cp .env.example .env
npm start

El endpoint local es http://localhost:8787/mcp. Abre http://localhost:8787/connect una vez para iniciar sesión a través de Cycleo. El servidor almacena únicamente el conjunto de tokens OAuth localmente con permisos de archivo restrictivos y renueva los tokens de acceso automáticamente. Establece CYCLEO_API_BASE_URL a una API local de Cycleo cuando desarrolles contra un checkout local.

Related MCP server: sprout-mcp

Límite de producción

El servidor MCP nunca recibe ni almacena contraseñas de Cycleo y nunca se conecta a la base de datos de Cycleo. Acepta un token de portador OAuth, valida la identidad mediante GET /auth/me y solo reenvía las rutas de lectura de la lista de permitidos en src/tools.mjs.