MCP 协议详解：与 Function Call 的区别及 Python 使用指南

对应的 Python OpenAI 代码如下。我们将 tools 部分放入一个包含 dict 的 list，作为 create 函数的 tools 参数即可。同时 tool_choice 传入 auto 代表自动选择工具。这里演示使用了硅基流动提供的 Qwen2.5 模型，运行前请确保修改 api_key 为正确值。

import openai
import json

def main():
    client = openai.OpenAI(
        api_key="xxxxx",
        base_url="https://api.siliconflow.cn/v1"
    )
    tools = [{
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "获取指定城市的天气",
            "parameters": {
                "type": "object",
                "properties": {
                    "city": { "type": "string", "description": "城市名" }
                },
                "required": ["city"]
            }
        }
    }]
    res = client.chat.completions.create(
        model="Qwen/Qwen2.5-32B-Instruct",
        messages=[
            { "role": "system", "content": "你是一个天气查询助手" },
            { "role": "user", "content": "帮我查询上海的天气" }
        ],
        tools=tools,
        tool_choice="auto"
    )
    print("content:", res.choices[0].message.content)
    print("tools:", res.choices[0].message.tool_calls)
    print("message:", res.choices[0].message.to_dict())

if __name__ == "__main__":
    main()

运行程序后，大模型会根据用户问题和提供的 tools 编写需要提供的参数。此时 content 会是空，不会输出直接内容，tool_calls 中会包含调用的工具和参数。

❯ uv run main.py
content: 
tools: [ChatCompletionMessageToolCall(id='...', function=Function(arguments='{"city": "上海"}', name='get_weather'), type='function')]
...

对应如下 JSON 格式响应，包含了我们的参数：

{
  "role": "assistant",
  "content": "",
  "tool_calls": [
    {
      "id": "...",
      "type": "function",
      "function": {
        "name": "get_weather",
        "arguments": "{\n \"city\": \"上海\"\n}"
      }
    }
  ]
}

调用工具并让 AI 二次处理

随后，我们可以根据大模型返回的参数调用我们的函数，得到结果后再与大模型进行对话。此时需要维护对话上下文，首先需要将第一次请求 AI 返回的结果插入到上下文中（"role": "assistant" 的 json 字符串），然后再插入工具调用的数据，格式如下：

{
  "role": "tool",
  "tool_call_id": "...",
  "content": "{\"status\": \"success\", \"temp\": \"25\"}"
}

这样，AI 就能结合工具返回的实际数据生成最终回复。