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 inspectorInspector предоставляет URL-адрес для доступа к инструментам отладки в вашем браузере.