MCP（Model Context Protocol）模型上下文协议理论篇4 - 工具（Tools）

AIQL

已于 2024-12-24 22:55:56 修改

阅读量1.8k

点赞数 5

CC 4.0 BY-SA版权

分类专栏： MCP(Model Context Protocol) 文章标签： ai 信息与通信 gpt MCP

于 2024-12-12 11:32:56 首次发布

本文链接：https://blog.csdn.net/aiqlcom/article/details/144422279

MCP(Model Context Protocol) 专栏收录该内容

24 篇文章

订阅专栏

工具（Tools）是模型上下文协议（MCP）中的一个基本元素，它允许服务器向客户端暴露可执行的功能。通过工具，大语言模型（LLMs）可以与外部系统交互、执行计算并在现实世界中采取行动。工具的设计理念是模型控制，即服务器将工具暴露给客户端，目的是让AI模型能够自动调用这些工具。

工具的核心功能

发现（Discovery）：客户端可以通过tools/list端点列出可用的工具。
调用（Invocation）：工具通过tools/call端点被调用，服务器执行请求的操作并返回结果。
灵活性（Flexibility）：工具的范围从简单的计算到复杂的API交互，具有高度的灵活性。

工具与资源（Resources）不同，资源通常是静态的，而工具代表动态操作，可以修改状态或与外部系统交互。

工具的定义结构

每个工具的定义结构如下：

{
  "name": "string",          // 工具的唯一标识符
  "description": "string",   // 工具的人类可读描述
  "inputSchema": {           // 工具参数的JSON Schema
    "type": "object",
    "properties": { ... }    // 工具特定的参数
  }
}

工具的实现示例

以下是一个在MCP服务器中实现基本工具的示例：

const server = new Server({
  name: "example-server",
  version: "1.0.0"
}, {
  capabilities: {
    tools: {}
  }
});

// 定义可用的工具
server.setRequestHandler(ListToolsRequestSchema, async () => {
  return {
    tools: [{
      name: "calculate_sum",
      description: "Add two numbers together",
      inputSchema: {
        type: "object",
        properties: {
          a: { type: "number" },
          b: { type: "number" }
        },
        required: ["a", "b"]
      }
    }]
  };
});

// 处理工具执行
server.setRequestHandler(CallToolRequestSchema, async (request) => {
  if (request.params.name === "calculate_sum") {
    const { a, b } = request.params.arguments;
    return {
      toolResult: a + b
    };
  }
  throw new Error("Tool not found");
});

工具的模式示例

系统操作：与本地系统交互的工具。

{
  "name": "execute_command",
  "description": "Run a shell command",
  "inputSchema": {
    "type": "object",
    "properties": {
      "command": { "type": "string" },
      "args": { "type": "array", "items": { "type": "string" } }
    }
  }
}

API集成：封装外部API的工具。

{
  "name": "github_create_issue",
  "description": "Create a GitHub issue",
  "inputSchema": {
    "type": "object",
    "properties": {
      "title": { "type": "string" },
      "body": { "type": "string" },
      "labels": { "type": "array", "items": { "type": "string" } }
    }
  }
}

数据处理：用于数据转换或分析的工具。

{
  "name": "analyze_csv",
  "description": "Analyze a CSV file",
  "inputSchema": {
    "type": "object",
    "properties": {
      "filepath": { "type": "string" },
      "operations": {
        "type": "array",
        "items": {
          "enum": ["sum", "average", "count"]
        }
      }
    }
  }
}