Cosense MCP サーバー

Cosense用の MCP サーバー。

ツール

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

• get_page : 指定されたタイトルのページを取得します

• list_pages : リソース内の利用可能なページを一覧表示します

• search_pages : 指定されたクエリ文字列を含むページを検索します

• insert_lines : ページ内の指定された行の後にテキストを挿入します

Related MCP server: MCP Tool

MCP クライアント構成

次の環境変数が必要です。

• COSENSE_PROJECT_NAME : プロジェクト名

• COSENSE_SID : 認証用のセッションID

  • ページへの書き込みとプライベートページの読み取りに必要

  • 機密情報が含まれているため、慎重に取り扱ってください

  • 詳細については、 scrapboxlab/connect.sid を参照してください。

npmレジストリから実行

JSRレジストリ構成

このパッケージは、JSRでホストされている@cosense/stdと@cosense/typesに依存しています。npxを使用する前に、JSRレジストリをグローバルに設定する必要があります。

Linux/macOSの場合:

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

Windows (PowerShell) の場合:

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

または、グローバル設定を変更したくない場合は、代わりにソースから実行します（以下のセクションを参照）。

クライアントのJSON構成

JSR レジストリを構成したら、MCP クライアントを構成します。

{
  "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
npm install
npm run build

クライアントのJSON構成

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

デバッグ

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

npm run inspect

インスペクターは、ブラウザでデバッグ ツールにアクセスするための URL を提供します。

謝辞

このプロジェクトはfunwarioisii/cosense-mcp-serverからフォークされました。