使用说明

多源文档MCP服务器

A. 模型上下文协议（MCP）该服务器使克劳德等人工智能助手能够从多个来源搜索和查询文档。目前支持 语音流 和 克劳德代码 文档。

🚀 快速开始

先决条件

Python 3.10或更高版本
紫外线包管理器

安装

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

# Install dependencies
uv sync

运行服务器

# Run directly
uv run voiceflow-docs-mcp

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

🔧 配置

Claude桌面集成

将此配置添加到您的Claude Desktop配置文件中：

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

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

添加配置后，重新启动Claude Desktop。

📚 可用工具

服务器提供6个用于文档访问的专用工具：

工具	说明
`search_documentation`	在所有文档源中进行全文搜索，并进行相关性排名
`get_document`	按特定文档的确切路径或标识符检索该文档
`search_code_examples`	在文档中搜索代码片段和示例
`list_categories`	列出可用的文档类别和主题
`get_integration_docs`	获取特定于集成的文档和指南
`find_step_documentation`	查找分步教程和演练

📁 项目结构

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

🛠️ 技术细节

文档数据库

存储：带全文搜索的SQLite数据库（FTS5）
来源：多源支持（语音流、克劳德代码、可扩展）
索引：首次运行时自动，支持增量更新
搜索：全文搜索，BM25相关性排名

依赖项

包装	用途
`fastmcp`	MCP服务器框架
`beautifulsoup4`	HTML解析和清理
`httpx`	用于获取文档的异步HTTP客户端
`markdownify`	HTML到Markdown的转换
`playwright`	文档的Web抓取
`python-frontmatter`	在Markdown中解析YAML frontmatter
`pyyaml`	YAML处理

数据源

语音流文档 （182张图片）

完整的语音流平台文档
API参考资料、指南、教程
集成文档

Claude代码文档 （12张图片）

Claude Code功能文档
设置和配置指南
最佳实践和故障排除

🔍 用法示例

搜索文档

# 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"

查询特定文档

# 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"

🧪 发展

项目状态

✅ 多源文档支持
✅ 带有相关性排名的全文搜索
✅ 6个专用MCP工具
✅ 带FTS5的SQLite数据库
✅ 自动文档索引
✅ Claude桌面集成

添加新文档源

该服务器旨在支持多个文档源。要添加新源，请执行以下操作：

将文档文件添加到 data/your-source-name/
更新配置 voiceflow_docs_mcp/config.py
服务器将在重新启动时自动为新文件建立索引

🤝 贡献

欢迎投稿！请随时提交拉取请求。

开发设置

# 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

📄 许可证

此项目根据MIT许可证获得许可-请参阅许可证文件以获取详细信息。

🙏 致谢

内置于 FastMCP -MCP服务器的Python框架
文件来源于语音流和克劳德代码
设计用于克劳德桌面

📞 支持

对于问题、疑问或贡献，请在GitHub上打开问题。