https://github.com/askme765cs/open-docs-mcp
An open-source MCP implementation providing document management functionality
https://github.com/askme765cs/open-docs-mcp
mcp mcp-server
Last synced: about 2 months ago
JSON representation
An open-source MCP implementation providing document management functionality
- Host: GitHub
- URL: https://github.com/askme765cs/open-docs-mcp
- Owner: askme765cs
- Created: 2025-03-24T19:00:12.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-04-08T16:30:23.000Z (6 months ago)
- Last Synced: 2025-08-09T12:45:31.943Z (about 2 months ago)
- Topics: mcp, mcp-server
- Language: JavaScript
- Homepage:
- Size: 87.9 KB
- Stars: 9
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
- mcp-index - Document Management Server - Crawl, index, and manage documentation while enabling full-text search across various document formats for efficient information retrieval. Integrates with AI to enhance document access and management capabilities. (Data Analytics)
README
# open-docs-mcp MCP Server
[](https://smithery.ai/server/@askme765cs/open-docs-mcp)
[](LICENSE)
[](package.json)
[](package.json)
An open-source MCP implementation providing document management functionality.
[中文文档][url-doczh]
## 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 aims to replicate 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
```bash
npx -y open-docs-mcp --docsDir ./docs
```
### Installing via Smithery
To install Document Management Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@askme765cs/open-docs-mcp):
```bash
npx -y @smithery/cli install @askme765cs/open-docs-mcp --client claude
```
### 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`
```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
```bash
npm run watch # Auto-rebuild on changes
npm run inspector # Debug with MCP Inspector
```
## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
## License
[MIT](LICENSE)
[url-doczh]: README.zh-CN.md