scrapbox-cosense-mcp

Английский | японский

Английский

MCP-сервер для cosense/scrapbox .

Функции

• get_page

  • Получить содержимое страницы из cosense/Scrapbox

    • Ввод: Заголовок страницы

    • Вывод: содержимое страницы, метаданные, ссылки и информация о редакторе.

• list_pages

  • Получить список страниц проекта (макс. 1000 страниц)

    • Вывод: Список заголовков страниц в проекте.

• search_pages

  • Полнотекстовый поиск по всем страницам проекта (макс. 100 страниц)

    • Поддерживает базовый поиск, поиск И, поиск ИЛИ и поиск НЕ

    • Вывод: Список заголовков страниц в результатах поиска.

• create_pages

  • Генерация URL-адресов страниц

    • Ввод: заголовок страницы и необязательный основной текст.

    • Вывод: URL-адрес, который можно открыть в браузере.

Разработка

Установить зависимости:

npm install

Сборка сервера:

npm run build

Автоматическая перестройка во время разработки:

npm run watch

Установка

git clone https://github.com/worldnine/scrapbox-cosense-mcp.git
cd scrapbox-cosense-mcp
npm install
npm run build

Для использования с 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", // Required for private projects
        "COSENSE_PAGE_LIMIT": "25", // Optional (default: 100)
        "COSENSE_SORT_METHOD": "created", // Optional (default: "updated")
        "SERVICE_LABEL": "scrapbox(cosense)" // Optional (default: "cosense(scrapbox)")
      }
    }
  }
}

Переменные среды

Этот сервер использует следующие переменные среды:

Требуемые переменные среды

• COSENSE_PROJECT_NAME : Название проекта

• COSENSE_SID : идентификатор сеанса для аутентификации Scrapbox/Cosense (требуется для частных проектов)

Необязательные переменные среды

• API_DOMAIN : домен API (по умолчанию: «scrapbox.io»)

• SERVICE_LABEL : Идентификатор службы (по умолчанию: «cosense (scrapbox)»)

• COSENSE_PAGE_LIMIT : Начальный лимит выборки страниц (1-1000, по умолчанию: 100)

• COSENSE_SORT_METHOD : Первоначальный порядок выборки страниц (обновлено/создано/доступно/связано/просмотры/заголовок, по умолчанию: обновлено)

Поведение переменной среды

• COSENSE_PROJECT_NAME : Требуемая переменная среды. Если этот параметр не установлен, сервер завершит работу с ошибкой.

• COSENSE_SID : требуется для доступа к частным проектам. Если не установлено, доступны только публичные проекты.

• API_ДОМЕН :

  • Используйте "scrapbox.io", если не установлено

  • Хотя эта опция не проверена на доменах, отличных от «scrapbox.io» в среде автора, она существует на случай, если в некоторых средах требуется «cosen.se».

• COSENSE_PAGE_LIMIT :

  • Если не установлено, используется 100.

  • Использует 100, если значение недопустимо (нечисло или выходит за пределы диапазона)

  • Допустимый диапазон: 1-1000

• COSENSE_SORT_METHOD :

  • Если не установлено, используется «обновлено»

  • Использует «обновлено», если значение недействительно

  • Не влияет на поведение инструмента list_pages (используется только для первоначальной выборки ресурсов)

Отладка

Поскольку серверы MCP взаимодействуют через stdio, отладка может быть сложной. Рекомендуется использовать MCP Inspector . Вы можете запустить его с помощью:

npm run inspector

Инспектор предоставляет URL-адрес для доступа к инструментам отладки в браузере.

Related MCP server: MCP File System Server

японский

Это MCP-сервер для cosense/scrapbox .

функция

• get_page

  • Получить содержимое страницы из cosense/Scrapbox

    • Ввод: Заголовок страницы

    • Вывод: содержимое страницы, метаданные, ссылки, информация о редакторе.

• list_pages

  • Получить список страниц проекта (до 1000)

    • Вывод: список заголовков страниц в проекте.

• search_pages

  • Полнотекстовый поиск по всем страницам проекта (до 100 результатов)

    • Поддерживает базовый поиск, поиск И, поиск ИЛИ и поиск НЕ

    • Вывод: Список заголовков страниц в результатах поиска.

• create_pages

  • Сгенерировать URL для страницы

    • Ввод: заголовок страницы и необязательный основной текст.

    • Вывод: URL-адрес, который можно открыть в браузере.

Метод разработки

Установите зависимости:

npm install

Сборка сервера:

npm run build

Автоматическая перестройка во время разработки:

npm run watch

Как установить

git clone https://github.com/worldnine/scrapbox-cosense-mcp.git
cd scrapbox-cosense-mcp
npm install
npm run build

Чтобы использовать его с 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", // オプション（デフォルト: 100）
        "COSENSE_SORT_METHOD": "created", // オプション（デフォルト: "updated"）
        "SERVICE_LABEL": "scrapbox(cosense)" // オプション（デフォルト: "cosense(scrapbox)"）
      }
    }
  }
}

переменные окружающей среды

Этот сервер использует следующие переменные среды:

Требуемые переменные среды

• COSENSE_PROJECT_NAME : Название проекта

• COSENSE_SID : идентификатор сеанса аутентификации Scrapbox/Cosense (требуется для частных проектов)

Необязательные переменные среды

• API_DOMAIN : домен API (по умолчанию: «scrapbox.io»)

• SERVICE_LABEL : Идентификационное имя службы (по умолчанию: «cosense (scrapbox)»)

• COSENSE_PAGE_LIMIT : Количество страниц для первоначального извлечения (1-1000, по умолчанию: 100)

• COSENSE_SORT_METHOD : порядок страниц при первоначальном извлечении (обновлено/создано/доступно/связано/просмотры/заголовок, по умолчанию: обновлено)

Поведение переменных окружения

• COSENSE_PROJECT_NAME : Это обязательная переменная среды. Если не установлено, сервер завершит работу с ошибкой при запуске.

• COSENSE_SID : требуется для доступа к частным проектам. Если не установлено, будут доступны только публичные проекты.

• API_ДОМЕН :

  • Если не указано, будет использоваться «scrapbox.io».

  • В среде автора значения, отличные от «scrapbox.io», не проверялись, но могут быть среды, в которых это не будет работать, если это не «cosen.se», так что это вариант на всякий случай.

• COSENSE_PAGE_LIMIT :

  • Если не установлено, используйте 100

  • Для недопустимых значений (нечисловых или выходящих за пределы диапазона) используйте 100.

  • Допустимый диапазон: 1-1000

• COSENSE_SORT_METHOD :

  • Если не установлено, используется «обновлено».

  • Для недопустимых значений используйте «обновлено».

  • Не влияет на работу инструмента list_pages (используется только при получении начальных ресурсов)

Как отлаживать

Серверы MCP взаимодействуют через stdio, поэтому их может быть сложно отлаживать. Мы рекомендуем использовать MCP Inspector . Это можно сделать с помощью следующей команды:

npm run inspector

Inspector предоставляет URL-адрес для доступа к инструментам отладки в вашем браузере.