万字长文：说清MCP的前世今生+RAGFlow整合应用示例

from openai import OpenAI


client = OpenAI(api_key="<DeepSeek API Key>", base_url="https://api.deepseek.com")


response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "system", "content": "You are a helpful assistant"},
        {"role": "user", "content": "Hello"},
    ],
    stream=False
)


print(response.choices[0].message.content)
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.

# 系统提示词设计
SYSTEM_PROMPT = """
你是一个智能助手，具有以下工具：


1. 时间工具 (TIME)
   - 格式：TIME: 获取当前时间
   - 功能：返回当前的完整日期和时间


2. 天气工具 (WEATHER)
   - 格式：WEATHER: 城市名称
   - 功能：获取指定城市的当前天气情况


3. 计算工具 (CALCULATE)
   - 格式：CALCULATE: 数学表达式
   - 功能：执行数学计算


重要规则：
- 必须严格遵循上述格式
- 只有在确实需要使用工具时才使用
- 工具调用应该是输出的唯一内容
- 使用工具后，还需要对结果进行自然语言解释


示例：
用户: 北京今天几点了？
助手: TIME: 获取当前时间


用户: 我想知道北京的天气
助手: WEATHER: 北京


用户: 帮我计算15乘以23
助手: CALCULATE: 15 * 23
"""


# 模拟工具实现
def mock_tool_execution(tool_call):
    import datetime
    
    if tool_call.startswith("TIME:"):
        return datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
    
    elif tool_call.startswith("WEATHER:"):
        city = tool_call.split("WEATHER:")[1].strip()
        # 模拟天气API
        return f"{city}：晴，温度22°C，湿度45%"
    
    elif tool_call.startswith("CALCULATE:"):
        expression = tool_call.split("CALCULATE:")[1].strip()
        try:
            return str(eval(expression))
        except Exception as e:
            return f"计算错误：{str(e)}"
    
    return "未识别的工具调用"


# 对话交互模拟
def chat_interaction():
    print("智能助手已启动。输入'退出'结束对话。")
    
    while True:
        user_input = input("用户: ")
        
        if user_input == '退出':
            break
        
        # 模拟模型处理
        # 实际场景中这里会是大语言模型的处理
        tool_match = None
        
        # 简单的规则匹配
        if "时间" in user_input:
            tool_match = "TIME: 获取当前时间"
        elif "天气" in user_input:
            city_match = user_input.replace("天气", "").strip()
            tool_match = f"WEATHER: {city_match}" if city_match else None
        elif "计算" in user_input or "*" in user_input or "+" in user_input:
            # 尝试提取计算表达式
            import re
            match = re.search(r'(\d+\s*[\+\-\*\/]\s*\d+)', user_input)
            if match:
                tool_match = f"CALCULATE: {match.group(1)}"
        
        if tool_match:
            print("助手:", tool_match)
            result = mock_tool_execution(tool_match)
            print(f"工具执行结果: {result}")
        else:
            print("助手: 很抱歉，我没有找到合适的工具来处理您的请求。")


# 运行交互
if __name__ == "__main__":
    chat_interaction()
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.
69.
70.
71.
72.
73.
74.
75.
76.
77.
78.
79.
80.
81.
82.
83.
84.
85.
86.
87.
88.
89.
90.
91.
92.
93.
94.
95.
96.
97.
98.
99.
100.
101.

智能助手已启动。输入'退出'结束对话。
用户: 现在几点了
助手: TIME: 获取当前时间
工具执行结果: 2024-03-18 16:45:30
用户: 北京天气怎么样
助手: WEATHER: 北京
工具执行结果: 北京：晴，温度22°C，湿度45%
用户: 计算15乘以23
助手: CALCULATE: 15 * 23
工具执行结果: 345
用户: 退出
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.

import os
from openai import OpenAI


# 初始化OpenAI客户端，配置阿里云DashScope服务
client = OpenAI(
    # 若没有配置环境变量，请用百炼API Key将下行替换为：api_key="sk-xxx",
    api_key=os.getenv("DASHSCOPE_API_KEY"),  # 从环境变量读取API密钥
    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
)


# 定义可用工具列表
tools = [
    # 工具1 获取当前时刻的时间
    {
        "type": "function",
        "function": {
            "name": "get_current_time",
            "description": "当你想知道现在的时间时非常有用。",
            "parameters": {}  # 无需参数
        }
    },  
    # 工具2 获取指定城市的天气
    {
        "type": "function",
        "function": {
            "name": "get_current_weather",
            "description": "当你想查询指定城市的天气时非常有用。",
            "parameters": {  
                "type": "object",
                "properties": {
                    "location": {
                        "type": "string",
                        "description": "城市或县区，比如北京市、杭州市、余杭区等。"
                    }
                },
                "required": ["location"]  # 必填参数
            }
        }
    }
]


# 节省篇幅，此处省略后续代码
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.

import datetime
import requests


def get_current_time():
    """manually retrieve current time"""
    return datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")


def get_current_weather(location):
    """manually fetch weather for a specific location"""
    # 模拟天气API调用
    try:
        # 假设这里是一个真实的天气API调用
        # 实际场景中，你需要替换为真实的API端点和处理逻辑
        response = requests.get(f"https://weather-api.example.com/current?city={location}")
        weather_data = response.json()
        return f"{location}的当前天气：{weather_data['temperature']}°C，{weather_data['condition']}"
    except Exception as e:
        return f"获取{location}天气失败：{str(e)}"


def process_user_query(query):
    """手动线性触发函数"""
    # 使用硬编码的条件判断
    if "时间" in query:
        return get_current_time()
    elif "天气" in query:
        # 需要额外的参数提取逻辑
        import re
        location_match = re.search(r'([\u4e00-\u9fff]+)天气', query)
        if location_match:
            location = location_match.group(1)
            return get_current_weather(location)
        else:
            return "请提供具体城市名称"
    else:
        return "无法理解您的请求"


# 模拟用户交互
def main():
    while True:
        user_input = input("请输入您的问题（输入'退出'结束）：")
        if user_input == '退出':
            break
        
        response = process_user_query(user_input)
        print("系统回复：", response)


if __name__ == "__main__":
    main()
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.

# 可能的交互示例
请输入您的问题（输入'退出'结束）：现在几点了
系统回复：2024-03-18 15:30:45


请输入您的问题（输入'退出'结束）：北京天气怎么样
系统回复：北京的当前天气：15°C，晴朗


请输入您的问题（输入'退出'结束）：退出
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.

# 1. manifest.json
{
    "schema_version": "v1",
    "name_for_human": "Time Assistant",
    "name_for_model": "time_tool_gpt",
    "description_for_human": "A GPT that can retrieve current time information across different time zones.",
    "description_for_model": "You are a helpful time assistant capable of retrieving current time information precisely and efficiently.",
    "auth": {
        "type": "none"
    },
    "api": {
        "type": "openapi",
        "url": "https://your-domain.com/openapi.yaml"
    },
    "logo_url": "https://example.com/time-assistant-logo.png",
    "contact_email": "support@example.com",
    "privacy_policy_url": "https://example.com/privacy"
}


# 2. openapi.yaml
openapi: 3.0.0
info:
  title: Time Assistant API
  version: 1.0.0
  description: API for retrieving current time information
servers:
  - url: https://your-domain.com/api/v1


paths:
  /current-time:
    get:
      summary: Get current time
      operationId: getCurrentTime
      parameters:
        - name: timezone
          in: query
          required: false
          schema:
            type: string
            default: "UTC"
          description: Timezone to retrieve current time (e.g., 'UTC', 'America/New_York', 'Asia/Shanghai')
      responses:
        '200':
          description: Successful time retrieval
          content:
            application/json:
              schema:
                type: object
                properties:
                  current_time:
                    type: string
                    example: "2024-03-18T15:30:45Z"
                  timezone:
                    type: string
                    example: "UTC"
                  timestamp:
                    type: integer
                    example: 1710770445
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.

{
  "messages": [
    {"role": "user", "content": "现在几点了？"}
  ],
  "context": {
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "get_current_time",
          "description": "当你想知道现在的时间时非常有用。",
          "parameters": {}
        }
      },
      {...}  // 另一个工具定义
    ]
  }
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.

{
  "response": {
    "model": "DeepSeek-R1:32b",
    "content": [
      {
        "type": "tool_use",
        "id": "call_1",
        "tool_use": {
          "name": "get_current_time",
          "parameters": {}
        }
      }
    ]
  }
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.

{
  "messages": [
    {"role": "user", "content": "现在几点了？"},
    {
      "role": "assistant",
      "content": [
        {
          "type": "tool_use",
          "id": "call_1",
          "tool_use": {
            "name": "get_current_time",
            "parameters": {}
          }
        }
      ]
    },
    {
      "role": "tool",
      "tool_use_id": "call_1",
      "content": {"time": "2025-03-18T14:30:00Z"}
    }
  ]
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.

{
  "response": {
    "model": "DeepSeek-R1:32b",
    "content": [
      {
        "type": "text",
        "text": "现在的时间是北京时间2025年3月18日22:30（世界协调时间14:30）。"
      }
    ]
  }
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.

将结果以标准格式返回，关联到对应的工具调用 ID
1.

{
  "messages": [
    {"role": "user", "content": "查询公司圆钢硬度标准"}
  ],
  "context": {
    "resources": [
      {
        "type": "database",
        "id": "materials_db",
        "config": {
          "engine": "mysql",
          "connection": {
            "host": "192.168.1.100",
            "database": "materials_specs",
            "schema": "standards"
          },
          "permissions": ["read"],
          "tables": ["material_standards", "quality_tests"],
          "access_level": "restricted"
        }
      }
    ],
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "query_database",
          "description": "查询企业材料标准数据库",
          "parameters": {
            "type": "object",
            "properties": {
              "resource_id": {"type": "string"},
              "query_type": {"type": "string", "enum": ["standard", "test", "material"]},
              "material_category": {"type": "string"},
              "standard_type": {"type": "string"}
            },
            "required": ["resource_id", "query_type"]
          }
        }
      }
    ]
  }
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.

{
  "messages": [
    {"role": "user", "content": "CNC加工中心出现S-02错误代码，如何排查？"}
  ],
  "context": {
    "prompts": [
      {
        "id": "mechanical_expertise",
        "content": "你是一名专业的机械加工技术顾问，熟悉CNC设备操作和故障排除。总是优先考虑安全因素，并遵循ISO 9001质量标准流程。在回答前，先确认错误的严重程度，然后按照'初步检查→可能原因→解决步骤→预防措施'的顺序组织回答。"
      },
      {
        "id": "company_terminology",
        "content": "使用公司标准术语：'加工中心'指HAAS VF-2SS设备，'S系列错误'表示主轴系统故障，'技术处理单'指企业内部ERP系统中的故障报告表单。参考设备代号时使用'HC-'前缀。"
      },
      {
        "id": "safety_guidelines",
        "content": "任何设备维修建议必须包含以下安全提醒：'维修前确保设备完全断电并上锁挂牌，穿戴适当的PPE装备，遵循公司MP-S-001安全手册规定的维修流程。'"
      }
    ],
    "resources": [
      {
        "type": "vector_database",
        "id": "equipment_manual_db",
        "config": {
          "collection": "equipment_manuals",
          "filters": {"equipment_type": "CNC"}
        }
      }
    ]
  }
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.

结合行业通用知识与企业特定知识
1.

提示词增强：设备故障回答必须包含：故障代码解释、可能原因（按概率排序）、诊断步骤（从简单到复杂）、维修所需工具清单、预计维修时间
1.

提示词增强：回答材料加工参数问题时，必须考虑企业现有设备能力限制，并参考企业工艺数据库中的历史成功案例
1.

提示词增强：分析质量问题时，自动关联企业SPC数据，引用相关ISO标准条款，并建议适用的企业标准检测方法
1.

┌─────────────────────────────────────────────────┐
│               RAGFlow + MCP 集成架构             │
├─────────────────┬───────────────────────────────┤
│                 │        LLM调用层              │
│                 ├───────────────────────────────┤
│  原有RAGFlow    │        向量检索层             │
│                 ├───────────────────────────────┤
│                 │        文档处理层             │
├─────────────────┼───────────────────────────────┤
│                 │        MCP适配器层 ◄──────────┼──► MCP协议定义
│                 ├───────────────────────────────┤
│  MCP扩展部分    │        资源访问控制层         │
│                 ├───────────────────────────────┤
│                 │        多源数据连接层         │
└─────────────────┴───────────────────────────────┘
                           ▲   ▲   ▲
                           │   │   │
                  ┌────────┘   │   └────────┐
                  │            │            │
             ┌────────┐   ┌────────┐   ┌────────┐
             │ MySQL  │   │  EMS   │   │ 其他系统│
             └────────┘   └────────┘   └────────┘
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.

"数控车床HC-2000最近频繁报E-35错误，是否有相关的维修记录？"
1.

{
  "response": {
    "model": "DeepSeek-R1:32b",
    "content": [
      {
        "type": "tool_use",
        "id": "call_1",
        "tool_use": {
          "name": "query_equipment_status",
          "parameters": {
            "resource_id": "production_db",
            "equipment_id": "HC-2000",
            "query_type": "maintenance_history"
          }
        }
      }
    ]
  }
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.

{
  "data": [
    {
      "date": "2025-02-15",
      "issue": "E-35错误：主轴编码器信号异常",
      "solution": "更换主轴编码器，调整编码器间隙"
    },
    {
      "date": "2025-01-20",
      "issue": "E-35错误：断续出现",
      "solution": "清洁线缆接头，重新固定连接器"
    }
  ]
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.

根据维修记录，HC-2000数控车床近期两次出现E-35错误（主轴编码器信号异常）：


1. 2025年2月15日：更换了主轴编码器并调整了编码器间隙
2. 2025年1月20日：清洁了线缆接头并重新固定连接器


从设备手册分析，E-35错误通常由以下原因导致：
- 编码器线缆损坏或接触不良（占70%的案例）
- 编码器本身故障（约20%的案例）
- 主轴驱动电路问题（约10%的案例）


建议采取以下步骤：
1. 检查编码器线缆是否有磨损或松动
2. 测量线缆连接器与编码器接口电阻值（应<0.2Ω）
3. 使用示波器检查编码器信号质量


根据企业SOP-M1001标准，此类问题需填写《设备异常跟踪表》并由维修部门评估是否需要调整预防性维护计划。
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.