Cosense MCP Server

🚀 Cosense MCP Server

A MCP server that provides services for Cosense.

🚀 Quick Start

✨ Features

The following tools can be used to interact with Cosense pages:

• get_page: Retrieve a page by the specified title.
• list_pages: List the available pages in the resource.
• search_pages: Search for pages containing the specified query string.
• insert_lines: Insert text into a page after the specified line.

📦 Installation

MCP Client Configuration

The following environment variables are required:

• COSENSE_PROJECT_NAME: The project name.
• COSENSE_SID: The session ID for authentication.
  • Required when writing to pages and reading private pages.
  • Handle with care as it contains sensitive information.
  • For more details, see scrapboxlab/connect.sid.

Running from the 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 globally configure the JSR registry:

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 don't want to modify the global settings, run directly from the source code (see below).

Client JSON Configuration

After configuring the 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"
      }
    }
  }
}

Running from Source Code

Cloning and Building

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

💻 Usage Examples

Debugging

Since the MCP server communicates via standard input and output, debugging can be challenging. We recommend using the MCP Inspector, which is provided as a package script:

npm run inspect

The inspector will provide a URL to access the debugging tools in the browser.

📄 License

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