cosense-mcp-server

by yosider

Integrations

  • The server depends on packages hosted on JSR registry (@cosense/std and @cosense/types) and requires configuration to access these dependencies.

  • Provides tools to interact with Cosense pages, which are part of the Scrapbox ecosystem. Features include retrieving pages, listing available pages, searching pages, and inserting text into pages.

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

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

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.

-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

The cosense-mcp-server facilitates the integration with Claude Desktop by serving as a middleware command pipeline server, allowing for interaction with projects in cosense.

  1. Tools
    1. MCP Client Configuration
      1. Run from npm registry
      2. Run from source
      3. Debugging
    2. Acknowledgments

      Related MCP Servers

      • -
        security
        F
        license
        -
        quality
        An MCP server that allows Claude to access pages from Cosense projects, supporting both public and private projects with optional SID authentication.
        Last updated -
        JavaScript
        • Apple
      • -
        security
        F
        license
        -
        quality
        An MCP server that allows AI assistants like Claude to execute terminal commands on the user's computer and return the output, functioning like a terminal through AI.
        Last updated -
        7
        Python
        • Apple
      • -
        security
        A
        license
        -
        quality
        A server that lets Claude desktop app execute terminal commands on your computer and edit files through Model Context Protocol, featuring command execution, process management, and advanced file operations.
        Last updated -
        15,956
        MIT License
        • Linux
        • Apple
      • -
        security
        F
        license
        -
        quality
        An MCP server that allows Claude to interact with Discord by providing tools for sending/reading messages and managing server resources through Discord's API.
        Last updated -
        JavaScript

      View all related MCP servers

      ID: arzvlylcom