modusop-mcp

@modusop/mcp-server

Modus Brain 用の Stdio→HTTP プロキシです。Claude Desktop、Cursor、Cline、Continue.dev など、MCP 対応の AI クライアントから ModusOp 組織のナレッジベースにアクセスできます。

概要

このパッケージは薄いプロキシです。一方では MCP の stdio トランスポートを使用し、もう一方ではすべての JSON-RPC リクエストを Modus Brain の HTTP MCP エンドポイントに転送します。

すべてのツール実装は Modus Brain 自体にあります。ModusOp が Brain の新しいツールをリリースすると、このパッケージをインストール済みのすべての環境で、次のリクエストから自動的に利用できます。再公開やバージョン更新、ユーザー側の操作は不要です。

AI クライアントがリモート HTTP MCP にネイティブ対応している場合、このパッケージは不要です。https://brain.modusop.app/mcp に直接接続してください。このパッケージは、stdio のみを使用するクライアント向けです。

セットアップ

1. Brain トークンを取得する

brain.modusop.app にサインインし、使用するデバイスまたはユーザー向けのラベルを付けてトークンを生成し、平文の値をコピーします（一度しか表示されません）。

2. AI クライアントの MCP 設定に追加する

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "modusop-brain": {
      "command": "npx",
      "args": ["-y", "@modusop/mcp-server"],
      "env": {
        "MODUSOP_API_TOKEN": "mo_brain_..."
      }
    }
  }
}

Cursor / Cline / Continue.dev — .cursor/mcp.json（または同等のファイル）：

{
  "mcpServers": {
    "modusop-brain": {
      "command": "npx",
      "args": ["-y", "@modusop/mcp-server"],
      "env": {
        "MODUSOP_API_TOKEN": "mo_brain_..."
      }
    }
  }
}

3. クライアントを再起動する

終了してから、もう一度開きます。数秒以内に MCP インジケーターに Modus Brain のツールが表示されます。

環境変数

変数	必須	デフォルト	備考
MODUSOP_API_TOKEN	はい	—	brain.modusop.app の Brain トークン
MODUSOP_BRAIN_URL	いいえ	https://brain.modusop.app/mcp	ローカルでの Brain 開発時のみ上書き

利用可能なツール

Brain が公開しているすべてのツールを利用できます。tools/list には現在のツール一覧が反映されます。v1.0.0 時点では、次のツールを利用できます。

• whoami — このトークンの対象ユーザーと組織を確認します
• search_knowledge — 組織の KB をセマンティック検索します
• get_chunk — 特定の検索結果を詳しく確認します
• list_recent — 最近インデックス化された KB アイテムを一覧表示します
• get_client_brief — クライアントの概要資料を生成します
• add_observation — メモを追加します
• add_decision — コンテキスト、決定、根拠を記録します
• link_observation — 2 つのチャンクを型付きリンクでつなぎます
• request_delete — 管理者の承認が必要な削除をリクエストします

0.x からの移行

このパッケージの 0.x バージョンでは、ツールをパッケージ内に実装し、/settings/api-tokens で発行した MO API トークンを使用して、ModusOp の旧 /api/mcp エンドポイントと通信していました。v1.0.0 では、この方式を廃止します。

• MO API トークンではなく、brain.modusop.app で新しい Brain トークンを生成してください
• MODUSOP_API_TOKEN の値を新しいトークンに置き換えてください
• ほかの設定変更は不要です。command、args、環境変数名はそのままです

以前のツール（search_projects、search_clients、get_client_context、start_timer など）は、このパッケージのカタログから削除されました。これらのツールは、同じ機能に加えてナレッジベースの検索と追記にも対応する Brain のツールに置き換えられています。以前のツールセットが必要な場合は、@modusop/[email protected] に固定してください。引き続き動作しますが、更新は配信されません。

ローカル開発

git clone https://github.com/jwwd-repos/modusop-mcp.git
cd modusop-mcp
npm install
MODUSOP_API_TOKEN=... npm run dev

このプロキシは標準入力から JSON-RPC を読み込み、標準出力に応答を書き込むため、次のコマンドで手動テストできます。

echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"whoami"}}' \
  | MODUSOP_API_TOKEN=... npm run dev

ライセンス

LICENSE.md を参照してください。