Cosense MCP Server

🚀 Cosense MCP サーバー

Cosense をサポートする MCP サーバーです。

🚀 クイックスタート

このサーバーは、Cosense へのアクセスを容易にするためのツールを提供します。以下に、主な機能と使用方法を説明します。

✨ 主な機能

利用可能なツール

以下のツールを使用して、Cosense ページとやり取りできます。

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

📦 インストール

MCP クライアントの設定

以下の環境変数が必要です。

• COSENSE_PROJECT_NAME: プロジェクト名
• COSENSE_SID: セッション ID。認証に使用されます。
  • ページの書き込みやプライベートページの読み取り時に必要です。
  • これには機密情報が含まれているため、取り扱いには注意が必要です。
  • 詳細については、scrapboxlab/connect.sid を参照してください。

npm レジストリからの実行

JSR レジストリの設定

このパッケージは @cosense/std と @cosense/types に依存しており、これらのパッケージは JSR 上にホストされています。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 サーバーは標準入出力を介して通信するため、デバッグは難しい場合があります。MCP インスペクター を使用することをおすすめします。これはパッケージスクリプトとして提供されています。

npm run inspect

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

📄 ライセンス

このプロジェクトは funwarioisii/cosense-mcp-server から派生しています。