Glama
Sign In

cosense-mcp-server

by yosider
npmGitHub
TypeScript
7
3
  • Apple
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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.

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.

This server cannot be installed

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

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 Resources