Cosense MCP Server

A MCP server for Cosense.

Tools

The following tools are available for interacting with Cosense pages:

• get_page: Retrieves a page with the specified title
• list_pages: Lists available pages in the resources
• search_pages: Searches for pages containing the specified query string
• insert_lines: Inserts text after a specified line in a page

MCP Client Configuration

The following environment variables are required:

• COSENSE_PROJECT_NAME: Project name
• COSENSE_SID: Session ID for authentication
  • Required for writing to pages and reading private pages
  • Handle with care as it contains sensitive information
  • For more details, see scrapboxlab/connect.sid
• NODE_ENV: Execution environment (development or production)
  • Controls logging behavior
  • In development mode, debug logs are displayed
  • In production mode, debug logs are suppressed

Run from npm registry

JSR registry configuration

This package depends on @cosense/std and @cosense/types which are hosted on JSR. Before using npx, you need to configure the JSR registry globally:

For Linux/macOS:

echo "@jsr:registry=https://npm.jsr.io" >> ~/.npmrc

For Windows (PowerShell):

echo "@jsr:registry=https://npm.jsr.io" >> $env:USERPROFILE\.npmrc

Or if you prefer not to modify global settings, run from source instead (see the section below)

Client json configuration

After configuring JSR registry, configure your MCP client:

{
  "mcpServers": {
    "cosense-mcp-server": {
      "command": "npx",
      "args": ["-y", "@yosider/cosense-mcp-server"],
      "env": {
        "COSENSE_PROJECT_NAME": "your_project_name",
        "COSENSE_SID": "your_sid"
      }
    }
  }
}

Run from source

Clone and build

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

Client json configuration

{
  "mcpServers": {
    "cosense-mcp-server": {
      "command": "npx",
      "args": ["-y", "/path/to/cosense-mcp-server"],
      "env": {
        "COSENSE_PROJECT_NAME": "your_project_name",
        "COSENSE_SID": "your_sid"
      }
    }
  }
}

For development debugging, add "NODE_ENV": "development" to the env section. Note that setting environment variables in a .env file won't work due to execution timing - use the MCP client configuration instead.

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspect

The Inspector will provide a URL to access debugging tools in your browser.

Acknowledgments

This project is forked from funwarioisii/cosense-mcp-server.