Multi-Source Documentation MCP Server

A Model Context Protocol (MCP) server that enables AI assistants like Claude to search and query documentation from multiple sources. Currently supports Voiceflow and Claude Code documentation.

🚀 Quick Start

Prerequisites

• Python 3.10 or higher
• uv package manager

Installation

# Clone the repository
git clone <your-repo-url>
cd voiceflow-docs-mcp

# Install dependencies
uv sync

Running the Server

# Run directly
uv run voiceflow-docs-mcp

# Or as a Python module
python -m voiceflow_docs_mcp.server

🔧 Configuration

Claude Desktop Integration

Add this configuration to your Claude Desktop config file:

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

{
  "mcpServers": {
    "voiceflow-docs": {
      "command": "uv",
      "args": ["run", "voiceflow-docs-mcp"],
      "cwd": "/absolute/path/to/voiceflow-docs-mcp"
    }
  }
}

After adding the configuration, restart Claude Desktop.

📚 Available Tools

The server provides 6 specialized tools for documentation access:

Tool	Description
search_documentation	Full-text search across all documentation sources with relevance ranking
get_document	Retrieve a specific document by its exact path or identifier
search_code_examples	Search for code snippets and examples across documentation
list_categories	List available documentation categories and topics
get_integration_docs	Get integration-specific documentation and guides
find_step_documentation	Find step-by-step tutorials and walkthroughs

📁 Project Structure

voiceflow-docs-mcp/
├── voiceflow_docs_mcp/          # Main MCP server package
│   ├── __init__.py              # Package initialization
│   ├── server.py                # MCP server implementation (6 tools)
│   ├── db_manager.py            # SQLite database operations
│   ├── config.py                # Configuration and environment handling
│   └── parser.py                # Markdown documentation parser
│
├── data/                        # Documentation content (1.3 MB)
│   ├── voiceflow_docs/          # 182 Voiceflow documentation files
│   └── claude_code_docs/        # 12 Claude Code documentation files
│
├── .claude/                     # Claude Code configuration
│   ├── QUICK_START.md           # Quick start guide
│   ├── README.md                # Claude-specific readme
│   └── settings.local.json      # Local settings (gitignored)
│
├── .gitignore                   # Git ignore rules
├── .python-version              # Python version specification (3.10+)
├── pyproject.toml               # Project metadata and dependencies
├── uv.lock                      # Locked dependency versions
├── LICENSE                      # MIT License
└── README.md                    # This file

🛠️ Technical Details

Documentation Database

• Storage: SQLite database with full-text search (FTS5)
• Sources: Multi-source support (Voiceflow, Claude Code, extensible)
• Indexing: Automatic on first run, incremental updates supported
• Search: Full-text search with BM25 relevance ranking

Dependencies

Package	Purpose
fastmcp	MCP server framework
beautifulsoup4	HTML parsing and cleaning
httpx	Async HTTP client for fetching docs
markdownify	HTML to Markdown conversion
playwright	Web scraping for documentation
python-frontmatter	Parse YAML frontmatter in Markdown
pyyaml	YAML processing

Data Sources

Voiceflow Documentation (182 files)

• Complete Voiceflow platform documentation
• API references, guides, tutorials
• Integration documentation

Claude Code Documentation (12 files)

• Claude Code feature documentation
• Setup and configuration guides
• Best practices and troubleshooting

🔍 Usage Examples

Searching Documentation

# When connected to Claude Desktop, you can ask:
"Search the Voiceflow docs for information about API blocks"
"Find code examples for integrating with external APIs"
"What are the available Voiceflow integrations?"
"Show me step-by-step guides for setting up a voice assistant"

Querying Specific Documents

# Ask Claude to retrieve specific documentation:
"Get the document about Voiceflow agent variables"
"Show me the integration docs for Zapier"
"Find the documentation on condition blocks"

🧪 Development

Project Status

• ✅ Multi-source documentation support
• ✅ Full-text search with relevance ranking
• ✅ 6 specialized MCP tools
• ✅ SQLite database with FTS5
• ✅ Automatic documentation indexing
• ✅ Claude Desktop integration

Adding New Documentation Sources

The server is designed to support multiple documentation sources. To add a new source:

1. Add documentation files to data/your-source-name/
2. Update configuration in voiceflow_docs_mcp/config.py
3. The server will automatically index new files on restart

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Development Setup

# Clone and install
git clone <your-repo-url>
cd voiceflow-docs-mcp
uv sync

# Run in development mode
uv run python -m voiceflow_docs_mcp.server

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built with FastMCP - A Python framework for MCP servers
• Documentation sourced from Voiceflow and Claude Code
• Designed for use with Claude Desktop

📞 Support

For issues, questions, or contributions, please open an issue on GitHub.

---

Note: This is an unofficial community project and is not affiliated with Anthropic or Voiceflow.