Cosense MCP Server

MCP-сервер для работы с Cosense — сервисом для ведения заметок и совместной работы. Позволяет получать, искать и редактировать страницы проекта через протокол MCP.

Доступные инструменты

Сервер предоставляет четыре инструмента для взаимодействия со страницами Cosense:

• get_page — получает содержимое страницы по указанному заголовку.
• list_pages — выводит список доступных страниц в ресурсах.
• search_pages — ищет страницы, содержащие заданную строку запроса.
• insert_lines — вставляет текст после определённой строки на странице.

Конфигурация клиента MCP

Для работы необходимы две переменные окружения:

• COSENSE_PROJECT_NAME — имя вашего проекта в Cosense.
• COSENSE_SID — сессионный идентификатор для аутентификации (connect.sid). Этот ключ требуется для записи на страницы и чтения приватных страниц. Обращайтесь с ним осторожно: он содержит чувствительные данные.

Инструкцию по получению SID можно найти на странице scrapboxlab/connect.sid.

Установка и запуск

Через npm registry (npx)

Пакет зависит от @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

Если не хотите менять глобальные настройки, запустите сервер из исходников (см. ниже).

После настройки реестра добавьте в конфигурацию вашего MCP-клиента (например, claude_desktop_config.json):

{
  "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

Затем настройте MCP-клиент, указав путь к собранному пакету:

{
  "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-серверы работают через stdio, отладка может быть затруднена. Рекомендуем использовать MCP Inspector — он доступен как скрипт пакета:

npm run inspect

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

Благодарности

Этот проект является форком funwarioisii/cosense-mcp-server. Спасибо автору за основу.