Reflex Docs MCP服务器
给你的LLM一个反射文档的“摄影记忆”。
该项目是 模型上下文协议(MCP)服务器 旨在将AI代理嵌入到最新的实际文档中 反射 web框架。
🚀 现场演示部署地点: https://reflex-docs-mcp.onrender.com
什么是反射?
Reflex是一个纯Python web框架,无需编写JavaScript即可构建全栈web应用程序。 它允许开发人员完全用Python定义UI、状态和后端逻辑,Reflex将Python编译成一个现代的、反应式的web应用程序。
为什么存在这种情况?
LLM在编写Reflex代码时经常产生参数幻觉或使用过时的语法。此服务器通过将有效的最新文档公开为 工具 LLM可以按需呼叫。
人工智能不像猜测,而是像开发人员一样工作:
- 搜索 组件的文档(例如。,
search_docs("rx.foreach")). - 倒像 特定页面(
get_doc("library/dynamic-rendering/foreach")). - 检查 组件模式(
get_component("rx.button")). - 写 基于地面事实的准确、可工作的代码。
______________________________________________________________________
特性
- 全文搜索 使用SQLite FTS5的Reflex文档(超快\<2ms响应)
- 节级检索 为LLM提供所需的上下文(节省令牌)
- 成份指数 允许查找每个对象的属性和类别
rx.*组件 - 可部署API 通过FastAPI,准备渲染/Railway/Vercel
- 零幻觉工作流程 当集成到代理循环中时
API终点
| 端点 | 描述 |
|---|---|
GET / | 健康检查 |
GET /search?query=...&limit=10 | 搜索文档 |
GET /doc/{slug} | 获取完整页面 |
GET /components?category=... | 列出组件 |
GET /component/{name} | 获取组件信息 |
GET /stats | 数据库统计 |
本地开发
# Clone and install
git clone https://github.com/yourusername/reflex-docs-mcp.git
cd reflex-docs-mcp
python -m venv .venv
.venv\Scripts\activate # Windows
pip install -e .
# Index the docs (downloads Reflex docs and builds search index)
python -m src.reflex_docs_mcp.indexer
# Run the API server
python api.py
# Open http://localhost:8000项目结构
├── api.py # FastAPI server (deploy this)
├── main.py # MCP stdio entry point
├── src/reflex_docs_mcp/
│ ├── models.py # Pydantic data models
│ ├── database.py # SQLite + FTS5 operations
│ ├── parser.py # Markdown parser
│ ├── indexer.py # Docs cloning & indexing
│ └── server.py # MCP server (stdio)
├── render.yaml # Render deployment config
├── Procfile # Process definition
└── test.py # Groq + MCP agentic demoMCP工具(用于stdio模式)
| 工具 | 说明 |
|---|---|
search_docs(query) | Reflex文档全文搜索 |
get_doc(slug) | 通过slug检索完整的文档页面 |
list_components(category?) | 列出所有记录在案的Reflex组件 |
get_component(name) | 获取特定组件的信息 |
