{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_d3pzph8tjfgn","handle":"rag-mcp-server-lizhibing","url":"https://wellknown.network/agents/rag-mcp-server-lizhibing","links":{"self":"https://wellknown.network/agents/rag-mcp-server-lizhibing/record.json","html":"https://wellknown.network/agents/rag-mcp-server-lizhibing","markdown":"https://wellknown.network/agents/rag-mcp-server-lizhibing/record.md","api":"https://wellknown.network/api/v1/agents/rag-mcp-server-lizhibing","status":"https://wellknown.network/api/v1/agents/rag-mcp-server-lizhibing/status","claim":"https://wellknown.network/agents/rag-mcp-server-lizhibing/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/rag-mcp-server-lizhibing/claim.json","badge":"https://wellknown.network/agents/rag-mcp-server-lizhibing/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:rag-mcp-server-lizhibing","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"rag-mcp-server-lizhibing","summary":"RAG MCP Server for document search and retrieval","description":"# RAG MCP 服务器使用指南\n\n## 什么是 RAG MCP 服务器？\n\n这是一个基于 MCP (Model Context Protocol) 的 RAG (Retrieval-Augmented Generation) 服务器，它允许 AI 助手访问和管理知识库，进行智能问答和文档检索。\n\n## 功能特性\n\n- 📚 **文档管理**: 添加、删除、查询文档\n- 🔍 **智能搜索**: 基于语义相似度的文档检索\n- 💬 **问答系统**: 根据知识库内容回答问题\n- 🏷️ **元数据支持**: 为文档添加分类、标签等元信息\n- 📊 **统计分析**: 查看知识库状态和统计信息\n\n## 快速开始\n\n### 1. 启动服务器\n\n```bash\n# 在后台启动服务器\npython rag_server.py\n\n# 或者直接运行（会阻塞终端）\npython rag_server.py\n```\n\n### 2. 配置 MCP 客户端\n\n在支持 MCP 的 AI 客户端（如 Claude Desktop）中，添加以下配置：\n\n```json\n{\n  \"mcpServers\": {\n    \"rag-server\": {\n      \"command\": \"python\",\n      \"args\": [\"/path/to/your/rag-mcp-server/rag_server.py\"],\n      \"env\": {\n        \"PYTHONPATH\": \"/path/to/your/rag-mcp-server\"\n      }\n    }\n  }\n}\n```\n\n### 3. 使用示例\n\n启动后，AI 助手就可以使用以下工具：\n\n#### 添加文档\n```\nadd_document(\"文档内容\", {\"category\": \"技术\", \"language\": \"中文\"})\n```\n\n#### 搜索文档\n```\nsearch_documents(\"人工智能\")\n```\n\n#### 获取文档\n```\nget_document(\"doc_0\")\n```\n\n#### 列出所有文档\n```\nlist_documents()\n```\n\n#### 删除文档\n```\ndelete_document(\"doc_0\")\n```\n\n#### 获取服务器信息\n```\nget_server_info()\n```\n\n## 配置选项\n\n服务器支持以下配置：\n\n- `max_results`: 最大搜索结果数量 (默认: 5)\n- `similarity_threshold`: 相似度阈值 (默认: 0.7)\n- `supported_formats`: 支持的文档格式\n- `enable_logging`: 是否启用日志记录\n\n## 支持的文档格式\n\n- 纯文本\n- Markdown\n- 结构化数据 (JSON)\n\n## 故障排除\n\n### 常见问题\n\n1. **服务器无法启动**\n   - 检查 Python 环境\n   - 确认依赖包已安装\n   - 查看错误日志\n\n2. **MCP 连接失败**\n   - 确认服务器正在运行\n   - 检查客户端配置路径\n   - 验证 Python 路径设置\n\n3. **文档添加失败**\n   - 检查文档内容格式\n   - 确认元数据格式正确\n   - 查看服务器日志\n\n### 日志查看\n\n服务器运行时会输出详细日志，包括：\n- 文档操作状态\n- 搜索请求处理\n- 错误和警告信息\n\n## 开发说明\n\n### 项目结构\n\n```\nrag-mcp-server/\n├── rag_server.py          # 主服务器文件\n├── rag_engine.py          # RAG 核心引擎\n├── mcp_client_config.json # MCP 客户端配置示例\n├── requirements.txt       # 依赖包列表\n└── README.md             # 使用说明\n```\n\n### 扩展功能\n\n你可以通过修改 `rag_engine.py` 来：\n- 添加新的文档格式支持\n- 自定义相似度算法\n- 集成外部数据源\n- 优化搜索性能\n\n## 技术支持\n\n如果遇到问题，请：\n1. 查看服务器日志输出\n2. 检查配置文件格式\n3. 确认环境依赖\n4. 参考错误信息进行排查\n\n---\n\n**注意**: 这是一个示例实现，生产环境使用前请进行充分测试和安全评估。","publisher":{"name":"Your Name","url":null},"homepage":"https://github.com/yourusername/rag-mcp-server","repository":"https://github.com/yourusername/rag-mcp-server","version":"0.1.10","license":"MIT","protocols":["mcp"],"tags":["mcp","rag","document-search","ai"],"pricing":null,"endpoints":[{"url":"pypi:rag-mcp-server-lizhibing","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.vector-search","name":"Vector Search","confidence":1,"provenance":"declared"}],"categories":["data"],"language":"fr"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"rag-mcp-server-lizhibing","registry":"pypi","observedAt":"2026-09-10T11:28:08.699Z","publishedAt":"2025-08-19T09:53:03.459309Z","latestVersion":"0.1.10"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"rag-mcp-server-lizhibing","url":"https://pypi.org/project/rag-mcp-server-lizhibing/","firstSeenAt":"2026-09-10T11:25:57.871Z","fetchedAt":"2026-09-10T11:25:57.871Z","normalizedAt":"2026-09-10T11:25:57.871Z"}]},"firstSeenAt":"2026-09-10T11:25:57.871Z","updatedAt":"2026-09-10T11:28:08.699Z"}