worldnine/scrapbox-cosense-mcpView GitHub Homepage for Latest Official Releases

Scrapbox/Cosenseプラットフォーム向けに設計されたMCPサーバー。ページ検索、検索、作成機能をサポート。

MITHTMLscrapbox-cosense-mcpworldnine 31 Last Updated: July 11, 2025

Scrapbox Cosense MCP サーバー プロジェクト紹介

プロジェクト概要

scrapbox-cosense-mcp は、cosense/scrapbox プラットフォーム専用に設計された MCP（Model Context Protocol）サーバーです。このプロジェクトは worldnine によって開発され、GitHub でホストされており、AI アプリケーションに Scrapbox 知識ベースとの標準化されたインターフェースを提供することを目的としています。

Scrapbox/Cosense とは？

Cosense は、知識管理プラットフォームであり、その中心的な理念は「生産性の鍵は知識にある」です。ユーザーは経験を共有し、知識を蓄積し、組織内で知識の複合的な成長を容易に実現できます。

主要機能

1. get_page（ページ取得）

  • 機能説明: cosense/Scrapbox からページの内容を取得します。
  • 入力パラメータ: ページタイトル
  • 出力内容: ページの内容、メタデータ、リンク情報、編集者情報

2. list_pages（ページ一覧）

  • 機能説明: プロジェクト内のページリストを取得します。
  • 制限条件: 最大 1000 ページまで返します。
  • 出力内容: プロジェクト内のすべてのページのタイトルリスト

3. search_pages（ページ検索）

  • 機能説明: プロジェクト内で全文検索を実行します。
  • 検索能力: 基本検索、AND 検索、OR 検索、NOT 検索をサポートします。
  • 制限条件: 最大 100 件の検索結果を返します。
  • 出力内容: 検索条件に一致するページのタイトルリスト

4. create_pages（ページ作成）

  • 機能説明: ページの URL を生成します。
  • 入力パラメータ: ページタイトルとオプションの本文
  • 出力内容: ブラウザで開くことができる URL

インストールと設定

ローカル開発環境へのインストール

# プロジェクトをクローン
git clone https://github.com/worldnine/scrapbox-cosense-mcp.git
cd scrapbox-cosense-mcp

# 依存関係をインストール
npm install

# サーバーをビルド
npm run build

# 開発時に自動的にリビルド
npm run watch

Claude Desktop との統合設定

Claude Desktop でこのサーバーを使用するには、設定ファイルにサーバー設定を追加する必要があります。

macOS 設定ファイルパス:

~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows 設定ファイルパス:

%APPDATA%/Claude/claude_desktop_config.json

設定例:

{
  "mcpServers": {
    "scrapbox-cosense-mcp": {
      "command": "npx",
      "args": ["github:worldnine/scrapbox-cosense-mcp"],
      "env": {
        "COSENSE_PROJECT_NAME": "your_project_name",
        "COSENSE_SID": "your_sid",
        "COSENSE_PAGE_LIMIT": "25",
        "COSENSE_SORT_METHOD": "created",
        "SERVICE_LABEL": "scrapbox(cosense)"
      }
    }
  }
}

環境変数について

必須変数

  • COSENSE_PROJECT_NAME: プロジェクト名（必須）
    • 設定されていない場合、サーバー起動時にエラーが発生して終了します。

オプション変数

  • COSENSE_SID: Scrapbox/Cosense 認証セッション ID

    • プライベートプロジェクトにアクセスする場合に必須です。
    • 設定されていない場合は、パブリックプロジェクトにのみアクセスできます。

  • API_DOMAIN: API ドメイン（デフォルト: "scrapbox.io"）

    • "cosen.se" を使用する必要がある環境向けにオプションを提供します。

  • SERVICE_LABEL: サービス識別子（デフォルト: "cosense (scrapbox)"）

  • COSENSE_PAGE_LIMIT: 初期ページ取得制限（デフォルト: 100）

    • 有効範囲: 1-1000
    • 範囲外の場合、自動的にデフォルト値が使用されます。

  • COSENSE_SORT_METHOD: 初期ページ取得順序（デフォルト: "updated"）

    • 選択可能な値: updated/created/accessed/linked/views/title
    • 初期リソース取得にのみ影響し、list_pages ツールには影響しません。

デバッグツール

MCP サーバーは stdio を介して通信するため、デバッグが難しい場合があります。プロジェクトでは、MCP Inspector を使用したデバッグを推奨しています。

npm run inspector

Inspector は URL を提供し、ブラウザでデバッグツールにアクセスできます。

プロジェクトの特徴

  1. 標準化されたインターフェース: このサーバーは、cosense/Scrapbox プロジェクトとのインタラクションを促進し、ユーザーがページの取得、一覧表示、検索、作成を行えるようにします。また、さまざまなクエリ操作とプライベートプロジェクトへの安全なアクセスをサポートします。

  2. セキュリティ: セッション ID を介したプライベートプロジェクトへのアクセスをサポートし、データの安全性を確保します。

  3. 柔軟な設定: さまざまな環境変数オプションを提供し、さまざまな使用シナリオに対応します。

  4. 開発に優しい: 開発モードでの自動リビルドと専用のデバッグツールを提供します。

使用シナリオ

  • 知識管理の自動化: Scrapbox を統合して、知識管理、共同ノート、チャットボットアプリケーションのページ読み書き機能を実装します。
  • AI アシスタントの強化: AI アプリケーションに構造化された知識ベースへのアクセス機能を提供します。
  • コンテンツ検索の最適化: 標準化された API を介して Scrapbox コンテンツを効率的に検索および検索します。
  • コラボレーションツールとの統合: Scrapbox のコラボレーション機能を他の AI ツールに統合します。

技術アーキテクチャ

このプロジェクトは Model Context Protocol アーキテクチャに基づいており、開発者は MCP サーバーを介してデータを公開したり、AI アプリケーション（MCP クライアント）を構築したりできます。プロジェクトは Node.js と TypeScript を使用して開発されており、MCP 標準プロトコル仕様に従っています。

まとめ

scrapbox-cosense-mcp は、機能が充実した MCP サーバーの実装であり、AI アプリケーションに Scrapbox 知識ベースと対話するための標準化された方法を提供します。基本的なページ操作をサポートするだけでなく、強力な検索機能と安全なプライベートプロジェクトアクセス機能を提供し、インテリジェントな知識管理システムを構築するための理想的なツールです。

Star History Chart