doc

This MCP server exposes a documentation-focused set of tools for interacting with the Shengwang docs site. The available tools are search-docs, list-docs, and get-doc-content. You can query for relevant documentation using search-docs to receive a list of matching documents with titles, categories, and URIs. Use get-doc-content with a specific docs:// URI to fetch the full content for a page, which can then be summarized or integrated into other workflows. The list-docs tool can enumerate documentation categories and provide structured metadata about docs paths and local URIs, useful for programmatic navigation or building tooling around the docs corpus. In agent or VS Code integrated scenarios, you can invoke these tools in combination to locate a topic and retrieve its content for use in code examples, UI components, or product documentation workflows.

Prerequisites:

• Node.js or Bun installed (the project recommends Bun for development).
• Access to a terminal.

Install and run:

1. Install Bun (if not already installed):

curl bun.sh | bash

2. Install dependencies (in project root):

bun install

3. Download initial docs data (if your setup provides a download script):

bun run doc:download

4. Start the MCP server in watch/development mode:

bun run dev:watch

5. Open the MCP endpoint in your browser or client:

• Local: http://localhost:3000/mcp
• Public: https://doc-mcp.shengwang.cn/mcp

If you need to run via npm scripts instead of Bun, ensure you adapt the commands to your environment accordingly (for example, npm install and npm run dev:watch).

Notes and tips:

• The MCP server exposes three core tools: search-docs, list-docs, and get-doc-content. Use them in sequence to locate and fetch documentation content efficiently.
• The public entry point is /mcp; ensure your firewall or proxy allows access to this path.
• When integrating with editors (e.g., VS Code) or agent modes, you can reference the MCP server by its URL and call the tools via the agent, similar to the examples in the documentation.
• If you encounter issues starting the server, verify that Bun is installed correctly and that local ports (default 3000) are available. Adjust the PORT environment variable if needed.
• The documentation data may be large; consider using the provided doc:download script (if available) to prefetch content for faster tool responses.