yosider/cosense-mcp-server
If you are the rightful owner of cosense-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
A MCP server for Cosense, providing tools for interacting with Cosense 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 titlelist_pages: Lists available pages in the resourcessearch_pages: Searches for pages containing the specified query stringinsert_lines: Inserts text after a specified line in a page
Installation
Prerequisites
Set the following environment variables:
COSENSE_PROJECT_NAME— your Cosense project name.COSENSE_SID— session cookie used for authentication. Required for writing pages and reading private pages. Treat this like a secret. See https://scrapbox.io/scrapboxlab/connect.sid for more details.
For VS Code Users
Use one of these one-click installation buttons:
Note: After clicking the button, replace
your_project_nameandyour_sidwith your actual values in the configuration. For manual setup, you can also edit directly.
For Claude Desktop Users
Add one of the following configurations to your claude_desktop_config.json:
Using pnpm
{
"mcpServers": {
"cosense-mcp-server": {
"command": "pnpm",
"args": ["-s", "dlx", "@yosider/cosense-mcp-server"],
"env": {
"COSENSE_PROJECT_NAME": "your_project_name",
"COSENSE_SID": "your_sid"
}
}
}
}
Using yarn
{
"mcpServers": {
"cosense-mcp-server": {
"command": "yarn",
"args": ["dlx", "-q", "@yosider/cosense-mcp-server"],
"env": {
"COSENSE_PROJECT_NAME": "your_project_name",
"COSENSE_SID": "your_sid"
}
}
}
}
Using npx
This package depends on JSR-hosted packages. npx requires adding the JSR registry to ~/.npmrc first.
Step 1: Add JSR registry to ~/.npmrc
Linux/macOS:
echo "@jsr:registry=https://npm.jsr.io" >> ~/.npmrc
Windows (PowerShell):
echo "@jsr:registry=https://npm.jsr.io" >> $env:USERPROFILE\\.npmrc
Step 2: Add configuration
{
"mcpServers": {
"cosense-mcp-server": {
"command": "npx",
"args": ["-y", "@yosider/cosense-mcp-server"],
"env": {
"COSENSE_PROJECT_NAME": "your_project_name",
"COSENSE_SID": "your_sid"
}
}
}
}
Development
Running from Source
If you prefer to run the server from a local copy of this repository, build it first:
git clone https://github.com/yosider/cosense-mcp-server.git
cd cosense-mcp-server
pnpm install
pnpm run build
Then configure your MCP client to use the local build:
{
"mcpServers": {
"cosense-mcp-server": {
"command": "node",
"args": ["/path/to/cosense-mcp-server/build/index.js"],
"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:
pnpm 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.
