Cycleo MCP 서버

배포 가능한 Cycleo용 읽기 전용 MCP 어댑터입니다. 서버는 소규모 허용 목록 도구 표면을 노출하며 사용자 범위의 OAuth 베어러 토큰으로 Cycleo의 버전이 지정된 JSON API를 호출합니다.

이 저장소에는 MCP 리소스 서버만 포함되어 있습니다. Cycleo는 인증 서버이자 데이터 소유자로 남아 있으며, /oauth/* 통합은 docs/auth-integration.md에 문서화되어 있으며 프로덕션 사용 전에 연결되어야 합니다.

로컬 실행

cp .env.example .env
npm start

로컬 엔드포인트는 http://localhost:8787/mcp입니다. http://localhost:8787/connect를 한 번 열어 Cycleo를 통해 로그인합니다. 서버는 제한적인 파일 권한으로 OAuth 토큰 세트만 로컬에 저장하며 액세스 토큰을 자동으로 갱신합니다. 로컬 체크아웃으로 개발할 때는 CYCLEO_API_BASE_URL을 로컬 Cycleo API로 설정하세요.

Related MCP server: sprout-mcp

프로덕션 경계

MCP 서버는 Cycleo 비밀번호를 수신하거나 저장하지 않으며 Cycleo 데이터베이스에 연결하지 않습니다. OAuth 베어러 토큰을 수락하고 GET /auth/me를 통해 신원을 검증하며 src/tools.mjs의 허용 목록에 있는 읽기 경로만 전달합니다.