Key Features
Hierarchical Navigation
Access document structure without loading entire files. Navigate through chapters, sections, and subsections efficiently.
Content Search
Search across all documentation content with relevance ranking. Find what you need quickly.
Include Resolution
Automatically resolves AsciiDoc include directives. Handles complex multi-file documentation projects.
Content Manipulation
Update and insert sections directly via MCP protocol. Atomic writes ensure data integrity.
File Watching
Automatic updates when files change externally. Always stay synchronized with your documentation.
Web Interface
Visual document structure browser with auto-launch. Navigate your documentation visually.
Quick Start
1 Install Dependencies
# Create virtual environment
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt2 Configure in Claude Code
Add to ~/.claude.json:
{
"mcpServers": {
"asciidoc-docs-server": {
"command": "/path/to/venv/bin/python3",
"args": ["-m", "src.mcp_server", "/path/to/docs"],
"env": {
"ENABLE_WEBSERVER": "true"
}
}
}
}That's it! The server will auto-start and open a web interface.
Read the full documentation →See It In Action
The MCP server includes an optional web interface for visual navigation
Enable with:
ENABLE_WEBSERVER=true
Web interface auto-launches and provides a visual overview of your documentation structure
Who Benefits?
AI/LLM Developers
Build LLM applications that need to work with large documentation. The MCP protocol provides structured access without token waste.
- Token-efficient document access
- Structured navigation API
- Ready for Claude Code integration
Documentation Teams
Manage complex arc42 or multi-file documentation projects with AI assistance. Keep documentation synchronized and accessible.
- Auto-refresh on file changes
- Include resolution for modular docs
- Visual web interface
Software Architects
Maintain architecture documentation (arc42, ADRs) with LLM support. Query and update documentation efficiently.
- Navigate 600+ page projects
- Atomic writes ensure integrity
- Search across all content
Architecture
Built with a clean, modular architecture following arc42 documentation standards.
- 82% test coverage (121/123 tests passing)
- Modular design (7 focused modules, all <500 lines)
- Zero data corruption (atomic writes with backup strategy)
- Performance (<2s startup, <100ms API response)
- Production ready (v2.0, fully documented)
- Well documented (complete arc42 + 8 ADRs)
Open Source
MCP Documentation Server is open source and available on GitHub.