多源文档MCP服务器
A. 模型上下文协议(MCP) 该服务器使克劳德等人工智能助手能够从多个来源搜索和查询文档。目前支持 语音流 和 克劳德代码 文档。
🚀 快速开始
先决条件
- Python 3.10或更高版本
- 紫外线 包管理器
安装
# Clone the repository
git clone
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
cd voiceflow-docs-mcp
uv sync
# Run in development mode
uv run python -m voiceflow_docs_mcp.server📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
🙏 致谢
📞 支持
对于问题、疑问或贡献,请在GitHub上打开问题。
______________________________________________________________________
备注:这是一个非官方的社区项目,与Anthropic或Voiceflow无关。
