Cycleo MCP server

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 を通じて ID を検証し、src/tools.mjs 内の許可リストに登録された読み取りルートのみを転送します。