Scrapbox Cosense MCP Server

scrapbox-cosense-mcp

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

Английский

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

Функции

• get_page
  • Получить содержимое страницы из cosense/Scrapbox
    • Ввод: Заголовок страницы
    • Вывод: содержимое страницы, метаданные, ссылки и информация о редакторе.
• list_pages
  • Получить список страниц проекта (макс. 1000 страниц)
    • Вывод: Список заголовков страниц в проекте.
• search_pages
  • Полнотекстовый поиск по всем страницам проекта (макс. 100 страниц)
    • Подд��рживает базовый поиск, поиск И, поиск ИЛИ и поиск НЕ
    • Вывод: Список заголовков страниц в результатах поиска.
• create_pages
  • Генерация URL-адресов страниц
    • Ввод: заголовок страницы и необязательный основной текст.
    • Вывод: URL-адрес, который можно открыть в браузере.

Разработка

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

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

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

Установка

Для использования с Claude Desktop добавьте конфигурацию сервера следующим образом:

Для MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json Для Windows: %APPDATA%/Claude/claude_desktop_config.json

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

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

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

• 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 . Вы можете запустить его с помощью:

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

японский

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

функция

• get_page
  • Получить содержимое страницы из cosense/Scrapbox
    • Ввод: Заголовок страницы
    • Вывод: содержимое страницы, метаданные, ссылки, информация о редакторе.
• list_pages
  • Получить список страниц проекта (до 1000)
    • Вывод: список заголовков страниц в проекте.
• search_pages
  • Полнотекстовый поиск по всем страницам проекта (до 100 результатов)
    • Поддерживает базовый поиск, поиск И, поиск ИЛИ и поиск НЕ
    • Вывод: Список заголовков страниц в результатах поиска.
• create_pages
  • Сгенерировать URL для страницы
    • Ввод: заголовок страницы и необязательный основной текст.
    • Вывод: URL-адрес, который можно открыть в браузере.

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

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

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

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

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

Чтобы использовать его с Claude Desktop, добавьте следующую конфигурацию сервера:

Для MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json Для Windows: %APPDATA%/Claude/claude_desktop_config.json

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

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

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

• 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 . Это можно сделать с помощью следующей команды:

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