deno-cosense-mcp-server

What is deno-cosense-mcp-server?

deno-cosense-mcp-server is an MCP (Model Context Protocol) server built with Deno that enables searching and retrieving pages from a Scrapbox (Cosense) project. It provides tools for querying project pages by keyword, fetching individual page content, and obtaining the Cosense syntax rules. Designed for developers who want to integrate Scrapbox/Cosense data into AI‑powered workflows.

How to use deno-cosense-mcp-server?

Set the environment variables COSENSE_PROJECT_NAME and COSENSE_SERVICE_ACCOUNT_ACCESS_KEY, then run either deno run --allow-net --allow-env --allow-read --import-map=import_map.json server.ts or deno task start. The server exposes three tools that can be called via the MCP protocol.

Key features of deno-cosense-mcp-server

• Searches Scrapbox pages by keywords (space-separated)
• Retrieves content of a specific page by title
• Fetches Cosense syntax rules
• Requires only Deno runtime (≥ v1.37.0)
• Authenticates via service account access key

Use cases of deno-cosense-mcp-server

• Integrate Scrapbox/Cosense knowledge bases with AI assistants
• Automate retrieval of project documentation for LLM context
• Build chat interfaces that can search and cite Scrapbox pages

FAQ from deno-cosense-mcp-server

What dependencies does deno-cosense-mcp-server require?

It requires Deno version 1.37.0 or higher and the environment variables COSENSE_PROJECT_NAME and COSENSE_SERVICE_ACCOUNT_ACCESS_KEY must be set.

How does authentication work?

Authentication is handled via a Scrapbox service account access key stored in the COSENSE_SERVICE_ACCOUNT_ACCESS_KEY environment variable.

Where do the data come from?

All data is fetched live from a Scrapbox/Cosense project specified by the COSENSE_PROJECT_NAME environment variable. No local persistence is mentioned.

What transports or communication protocols are used?

The server uses the Model Context Protocol (MCP) for tool invocation. No specific transport details (stdio, HTTP, etc.) are provided in the README.

Are there any known limits?

The README does not list any limits. Performance and rate limits depend on Scrapbox/Cosense’s API behavior and the user’s Deno environment.