askme765cs_open_docs_mcp

askme765cs_open_docs_mcp

by askme765cs
An open-source MCP server for document management, crawling, indexing, and full-text search.

Open Docs MCP Server: Document Management and Search Integration

License Node Version TypeScript

An open-source MCP implementation designed to provide robust document management and search capabilities. 中文文档

Features

Document Management

  • Crawl and index documentation from various sources
  • Support for multiple document formats
  • Full-text search capabilities

MCP Server API

  • Resource-based access to documents
  • Tool-based document management

Available Tools

  1. enable_doc - Enable crawling for a specific doc
  2. disable_doc - Disable crawling for a specific doc
  3. crawl_docs - Start crawling enabled docs
  4. build_index - Build search index for docs
  5. search_docs - Search documentation
  6. list_enabled_docs - List enabled docs
  7. list_all_docs - List all available docs

Cursor @Docs Compatibility

This project replicates Cursor's @Docs functionality by providing:
1. Document Indexing:
- Crawl and index documentation from various sources
- Support for multiple document formats (HTML, Markdown, etc.)
- Automatic re-indexing to keep docs up-to-date
2. Document Access:
- Search across all indexed documentation
- Integration with MCP protocol for AI context
3. Custom Docs Management:
- Add new documentation sources via enable_doc tool
- Manage enabled docs via list_enabled_docs tool
- Force re-crawl with crawl_docs tool

Architecture

┌───────────────────────────────────────────────────────┐
│                    open-docs-mcp Server                    │
├───────────────────┬───────────────────┬───────────────┤
│   Crawler Module  │  Search Engine    │  MCP Server   │
├───────────────────┼───────────────────┼───────────────┤
│ - Web crawling    │ - Full-text index │ - Resources   │
│ - Doc conversion  │ - Relevance score │ - Tools       │
│ - Storage         │ - Query parsing   │ - Prompts     │
└───────────────────┴───────────────────┴───────────────┘

Usage

npx -y open-docs-mcp --docsDir ./docs

Configuration

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "open-docs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "open-docs-mcp",
        "--docsDir",
        "/path/to/docs"
      ]
    }
  }
}

Configuration Options:
- command: Node.js executable
- args: Array of arguments to pass to the script
- --docsDir: Required, specifies docs directory path
- disabled: Set to true to temporarily disable the server
- alwaysAllow: Array of tool names that can be used without confirmation

Development

npm run watch  # Auto-rebuild on changes
npm run inspector  # Debug with MCP Inspector

Documentation

Full documentation is available in the docs directory.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License

MIT

Features & Capabilities

Categories
mcp_server model_context_protocol javascript typescript document_management search api_integration claude crawling indexing

Implementation Details

Stats

0 Views
0 Favorites
2 GitHub Stars

Repository Info

askme765cs Organization

Similar Servers

continuedev_continue by continuedev
0
0
0