Cosense MCP Server

Cosense MCP サーバー

Cosense 用の MCP サーバーです。

ツール

Cosense のページを操作するために、以下のツールを利用できます。

• get_page：指定したタイトルのページを取得します
• list_pages：リソース内の利用可能なページを一覧表示します
• search_pages：指定したクエリ文字列を含むページを検索します
• insert_lines：ページ内の指定した行の後にテキストを挿入します

インストール

前提条件

以下の環境変数を設定します。

• COSENSE_PROJECT_NAME — Cosense のプロジェクト名です。
• COSENSE_SID — 認証に使用するセッション Cookie です。ページへの書き込みや非公開ページの読み取りに必要です。秘密情報として扱ってください。詳細については、https://scrapbox.io/scrapboxlab/connect.sid を参照してください。

VS Code ユーザー向け

以下のワンクリックインストールボタンのいずれかを使用してください。

注：ボタンをクリックした後、設定内の your_project_name と your_sid を実際の値に置き換えてください。手動で設定する場合は、.vscode/mcp.json を直接編集することもできます。

Claude Desktop ユーザー向け

以下の設定のいずれかを claude_desktop_config.json に追加してください。

pnpm を使用する場合

{
  "mcpServers": {
    "cosense-mcp-server": {
      "command": "pnpm",
      "args": ["-s", "dlx", "@yosider/cosense-mcp-server"],
      "env": {
        "COSENSE_PROJECT_NAME": "your_project_name",
        "COSENSE_SID": "your_sid"
      }
    }
  }
}

yarn を使用する場合

{
  "mcpServers": {
    "cosense-mcp-server": {
      "command": "yarn",
      "args": ["dlx", "-q", "@yosider/cosense-mcp-server"],
      "env": {
        "COSENSE_PROJECT_NAME": "your_project_name",
        "COSENSE_SID": "your_sid"
      }
    }
  }
}

npx を使用する場合

このパッケージは JSR でホストされているパッケージに依存しています。npx を使用するには、まず JSR レジストリを ~/.npmrc に追加する必要があります。

ステップ 1：JSR レジストリを ~/.npmrc に追加する

Linux/macOS：

echo "@jsr:registry=https://npm.jsr.io" >> ~/.npmrc

Windows（PowerShell）：

echo "@jsr:registry=https://npm.jsr.io" >> $env:USERPROFILE\\.npmrc

ステップ 2：設定を追加する

{
  "mcpServers": {
    "cosense-mcp-server": {
      "command": "npx",
      "args": ["-y", "@yosider/cosense-mcp-server"],
      "env": {
        "COSENSE_PROJECT_NAME": "your_project_name",
        "COSENSE_SID": "your_sid"
      }
    }
  }
}

開発

ソースから実行する

このリポジトリのローカルコピーからサーバーを実行する場合は、まずビルドしてください。

git clone https://github.com/yosider/cosense-mcp-server.git
cd cosense-mcp-server
pnpm install
pnpm run build

次に、ローカルビルドを使用するよう MCP クライアントを設定します。

{
  "mcpServers": {
    "cosense-mcp-server": {
      "command": "node",
      "args": ["/path/to/cosense-mcp-server/build/index.js"],
      "env": {
        "COSENSE_PROJECT_NAME": "your_project_name",
        "COSENSE_SID": "your_sid"
      }
    }
  }
}

デバッグ

MCP サーバーは stdio 経由で通信するため、デバッグが難しい場合があります。パッケージスクリプトとして利用できる MCP Inspector の使用をおすすめします。

pnpm run inspect

Inspector は、ブラウザーでデバッグツールにアクセスするための URL を表示します。

謝辞

このプロジェクトは funwarioisii/cosense-mcp-server をフォークしたものです。