MCP SOP服务器
一种模型上下文协议（MCP）服务器，用于访问和搜索支持意大利语的标准操作程序（SOP）。
概述
此MCP服务器为AI代理提供了以下能力：
- 使用语义搜索搜索您公司的SOP文档
- 根据具体情况检索相关程序
- 按类别浏览SOP
- 获取在特定情况下该做什么的指导
服务器使用：
- ChromaDB 用于向量存储和语义搜索
- 句子转换 支持意大利语的多语言模型
- FastMCP 用于MCP服务器实现
- RAG（检索增强生成） 用于智能文档检索
特性
- 🇮🇹 意大利语支持：使用针对意大利语文本优化的多语言嵌入
- 📄 多格式支持：处理PDF和DOCX文档
- 🔍 语义搜索：根据含义而不仅仅是关键字查找相关SOP
- 📁 类别筛选：在特定SOP类别中搜索
- 🤖 AI就绪：提供结构化的响应，非常适合LLM消费
- ⚡ 快速检索：使用ChromaDB进行高效的基于矢量的搜索
- 🚀 延迟初始化：服务器启动迅速，文档在第一次请求时就被编入索引
安装
- 克隆存储库:
git clone https://github.com/dadapera/mcp-sop-server.git
cd mcp-sop-server- 创建并激活虚拟环境:
python -m venv venv
# On Windows
venv\Scripts\activate
# On macOS/Linux
source venv/bin/activate- 再进行:
pip install -r requirements.txt- 添加SOP文件:
创建一个 sop_documents/ 目录，并按类别文件夹组织SOP文件。
配置
MCP客户端设置
要将此服务器与Claude Desktop或其他MCP客户端一起使用，请将其添加到您的MCP客户端配置中：
适用于克劳德桌面 (mcp-client-config.json):
{
"mcpServers": {
"sop-server": {
"command": "/path/to/your/venv/Scripts/python.exe",
"args": ["/path/to/your/mcp-sop-server/main.py"],
"cwd": "/path/to/your/mcp-sop-server"
}
}
}备注：确保使用虚拟环境Python可执行文件的完整路径，并根据您的系统调整路径。
目录结构
服务器希望SOP文档按如下方式组织：
sop_documents/
├── SOP01 Quality System Documentation Management/
│ ├── document1.pdf
│ └── document2.docx
├── SOP02 HR management/
│ └── hr_procedures.pdf
├── SOP03 Design/
│ └── design_process.docx
└── ...用法
启动服务器
服务器通常由您的MCP客户端（如Claude Desktop）自动启动。如果手动运行：
python main.py服务器将：
- 快速启动并等待连接
- 在第一次工具调用时：扫描
sop_documents/目录 - 处理和提取PDF和DOCX文件中的文本
- 使用多语言模型生成嵌入
- 将所有内容存储在ChromaDB中，以便快速检索
可用工具
服务器提供以下MCP工具：
1. search_sop_documents
使用自然语言查询搜索相关SOP内容。
参数：
query（string）：意大利语或英语搜索查询max_results（int，可选）：返回的最大结果数（默认值：5）category（字符串，可选）：按SOP类别筛选
例子：
{
"query": "Come gestire una non conformità nel processo di produzione",
"max_results": 3,
"category": "SOP05 Non Conformity"
}2. get_sop_guidance
根据SOP文件获得特定情况的具体指导。
参数：
situation（string）：情况描述category（字符串，可选）：集中搜索特定类别
例子：
{
"situation": "Un cliente ha segnalato un difetto nel prodotto consegnato",
"category": "SOP05 Non Conformity"
}3. list_sop_categories
获取所有可用的SOP类别和收集统计数据。
4. get_sop_by_category
检索特定类别中的所有SOP。
参数：
category（string）：SOP类别名称
5. refresh_sop_database
刷新文档数据库（在SOP更新时使用）。
6. get_server_status
获取当前服务器状态和统计信息。
技术配置
嵌入模型
服务器使用 sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2 默认情况下支持意大利语。您可以在中更改此设置 src/mcp_sop_server/document_searcher.py:
model_name = "sentence-transformers/your-preferred-model"组块大小
文本分块可以在 src/mcp_sop_server/document_processor.py:
def chunk_text(self, text: str, chunk_size: int = 1000, overlap: int = 200):数据库位置
ChromaDB存储位置自动设置为 chroma_db/ 在项目根中。
查询示例
以下是您可以使用的一些示例查询：
意大利语：
- “如何处理不合规？”
- “基础设施维护程序”
- “内部审计怎么办？”
- “仓库和库存管理”
英语：
- “如何处理质量问题？”
- “软件开发生命周期程序”
- “风险管理协议”
- “员工培训要求”
故障排除
常见问题
- 未找到文档：确保SOP文件的目录结构正确
- 嵌入模型下载：首次运行可能需要时间来下载多语言模型
- 内存使用：大型文档集合可能需要更多的RAM来嵌入生成
- 路径问题：确保在MCP客户端配置中使用绝对路径
日志
服务器提供带有表情符号的详细日志记录，以提高可读性：
- 🚀 服务器启动和初始化
- 📄 文档处理状态
- 📊 处理统计
- ✅ 成功消息
- ❌ 错误消息
检查控制台输出或MCP客户端日志以获取详细信息。
发展
项目结构
mcp-sop-server/
├── src/mcp_sop_server/ # Main package
│ ├── __init__.py # Package initialization
│ ├── mcp_server.py # FastMCP server and tools
│ ├── document_processor.py # Document text extraction
│ └── document_searcher.py # Vector search with ChromaDB
├── main.py # Entry point
├── requirements.txt # Dependencies
├── test_server.py # Server testing
├── mcp-client-config.json # Example client configuration
└── README.md # This file添加新文档类型
要支持其他文件格式，请扩展 DocumentProcessor 类别：
def extract_text_from_new_format(self, file_path: Path) -> str:
# Implementation for new format
pass自定义搜索逻辑
修改 DocumentSearcher 类来实现自定义搜索算法或过滤器。
其他工具
通过定义新的MCP工具来添加它们 @mcp.tool() 室内装饰师 mcp_server.py.
许可证
该项目旨在供公司内部用于访问SOP文件。
支持
有关SOP MCP服务器的问题或疑问，请在GitHub存储库上创建问题。