creo-local

ローカルで動作するMCPサーバーです。クラウドAPIを経由してメモリを操作します。

Auth0 Device Authorization Grantによる認証で、ブラウザでログインするだけで30日間使用できます。

特徴

• ローカルで動作するMCPサーバー
• クラウドAPIと連携してメモリを保存・検索
• セマンティック検索（ベクトル類似度検索）対応
• Auth0 Device Authorization Grantで簡単ログイン
• Refresh Tokenで約30日間は再ログイン不要

アーキテクチャ

┌─────────────────────────────────────────────────────────┐
│ ローカル環境                                              │
│                                                          │
│  ┌──────────────────┐                                   │
│  │ creo-local-mcp   │                                   │
│  │                  │                                   │
│  │ MCPサーバー       │                                   │
│  └────────┬─────────┘                                   │
│           │                                              │
└───────────┼──────────────────────────────────────────────┘
            │ API リクエスト
            │ (Auth0認証)
            ▼
┌─────────────────────────────────────────────────────────┐
│ クラウド (app.creo-memories.in)                          │
│                                                          │
│  ┌──────────────────────┐    ┌───────────────────┐      │
│  │ creo-api-server      │───▶│ SurrealDB + Qdrant│      │
│  │ メモリ保存・検索       │    │ データストレージ    │      │
│  └──────────────────────┘    └───────────────────┘      │
└─────────────────────────────────────────────────────────┘

インストール

npm install -g creo-local

Claude Code / Cursor での設定

.mcp.json に追加:

{
  "mcpServers": {
    "creo-local": {
      "command": "npx",
      "args": ["-y", "creo-local"]
    }
  }
}

Bunを使用する場合

{
  "mcpServers": {
    "creo-local": {
      "command": "bunx",
      "args": ["creo-local"]
    }
  }
}

環境変数

| 変数名 | 説明 | デフォルト | |--------|------|-----------| | CREO_API_URL | クラウドAPI URL | https://app.creo-memories.in/api | | CREO_LOCAL_DATA_DIR | トークン保存先 | ~/.creo-local |

ツール

remember

メモリを保存します。

remember(content: string, metadata?: object)

• content: 記憶する内容
• metadata: メタデータ（タグ、カテゴリなど）

recall

関連するメモリをセマンティック検索します。

recall(query: string, limit?: number, threshold?: number)

• query: 検索クエリ（意味的に近いメモリを検索）
• limit: 取得件数（デフォルト: 5）
• threshold: 類似度閾値（デフォルト: 0.7）

forget

指定したメモリを削除します。

forget(id: string)

list_recent

最近のメモリを一覧表示します。

list_recent(limit?: number)

auth_status

認証状態を確認します。

logout

ログアウトして認証情報をクリアします。

認証フロー

初回使用時にAuth0 Device Authorization Grantでログインを促されます:

ログインが必要です

以下のURLをブラウザで開いてください:
  https://creo-memories.jp.auth0.com/activate?user_code=XXXX-XXXX

または https://creo-memories.jp.auth0.com/activate にアクセスして
コード: XXXX-XXXX を入力してください

認証を待機中...

• ブラウザでログイン後、自動的にトークンが保存されます
• Refresh Tokenにより、約30日間は再ログイン不要です
• トークンは ~/.creo-local/auth.json に保存されます

ライセンス

MIT