mcp-docs

This MCP server hosts your Markdown-based knowledge so agents can answer directly from your content. It exposes your docs, prompts, and supporting files as browsable resources, enabling workflows where curators can share knowledge across teams and workspace boundaries. The server supports three deployment modes: local STDIO for development, an npm package deployment for easy distribution, and a Cloudflare Worker deployment for remote access. When running in the MCP ecosystem, agents can query the docs, render Markdown, and follow reusable prompt templates to guide user interactions.

To get started, you can run the server locally using STDIO by leveraging the serve command described in the project docs. For production or distribution, you would publish the server as an npm package and install it across your environments, or deploy via a Cloudflare Worker for edge delivery. The documentation also highlights how to publish prompts, expose any file type as resources, and customize configurations to suit your organization.

Prerequisites:

• Node.js (recommended latest LTS) and npm/yarn installed
• Basic familiarity with running commands in your shell

Installation steps:

1. Install Node.js from https://nodejs.org/ if not already installed
2. Create or navigate to your MCP configuration directory
3. Run the server via npx (as shown in the README):

# Quick start using the recommended MCP server package
npx -y @circlesac/mcp-docs-server

Optionally, if you want to pin a specific version or install globally, you can also install from npm and run locally:

# Install the package locally (example)
npm install @circlesac/mcp-docs-server --save-dev
# Or install globally (not required for MCP usage but possible)
npm install -g @circlesac/mcp-docs-server

Deployment options:

• Local STDIO: use the serve command as described in the docs for development.
• npm Package: publish to npm and install across environments.
• Cloudflare Worker: follow the cloudflare deployment guide to run at edge.

Tips and considerations:

• This server exposes Markdown docs, prompts, and other file types as browsable resources for agents to access.
• You can create reusable prompt templates to guide workflows when answering questions from your docs.
• When configuring in MCP, you typically add an entry like: { "mcpServers": { "mcp-docs-server": { "command": "npx", "args": ["-y", "@circlesac/mcp-docs-server"] } } }.
• Ensure your Markdown/docs directory is accessible to the server, and consider versioning your content for consistent agent responses.
• If you plan to deploy via Cloudflare Worker, you’ll need to follow the corresponding deployment steps in the documentation and ensure your resources are properly served at the edge.