Defining tools with MCP

📝 MCP 服务器构建要点 (MCP Server Implementation Key Concepts)

一、项目目标与架构 (Project Goal & Architecture)

• 目标： 为 CLI 聊天机器人构建 MCP 服务器，添加额外的功能。
• 核心组件： MCP 服务器 (MCP server. py)。
• 初始功能： 实现两个工具 (Tools)：
• 读取文档 (Read Document)。
• 更新/编辑文档 (Update/Edit Document)。
• 数据存储： 所有文档初始存储在内存中的 docs 字典中（键为文档 ID，值为文档内容）。

二、MCP Python SDK 的使用 (Using the MCP Python SDK)

• 核心优势： 使用官方 MCP Python SDK，极大地简化了工具的定义过程。
• 工作原理： 开发者只需编写工具的 Python 代码（定义名称、描述和参数），SDK 会自动生成工具所需的 JSON Schema，供 Claude 使用。
• 定义流程： 通过 MCP. tool 装饰器或方法来定义工具。

三、工具实现细节 (Tool Implementation Details)

**1. 读取文档工具 (Read Document Tool)**

• 功能描述： 接收文档 ID，返回该文档的全部内容。
• 输入参数： doc_id (字符串，文档 ID)。
• 实现逻辑：
• 检查 doc_id 是否存在于 docs 字典中。
• 如果不存在，抛出 ValueError (提示文档未找到)。
• 如果存在，返回 docs[doc_id] 的值。

**2. 编辑文档工具 (Edit Document Tool)**

• 功能描述： 在指定文档中，将旧字符串替换为新字符串。
• 输入参数：
• doc_id (字符串，文档 ID)。
• old_string (字符串，需要匹配的旧文本)。
• new_string (字符串，用于替换的新文本)。
• 实现逻辑：
• 检查 doc_id 是否存在于 docs 字典中。
• 如果存在，执行替换操作：docs[doc_id] = docs[doc_id]. replace(old_string, new_string)。
• 如果不存在，抛出 ValueError。

Takeaways

• MCP服务器用于为CLI聊天机器人构建，初始核心功能是实现文档读取和编辑工具。
• 使用MCP Python SDK，开发者只需编写工具的Python代码，SDK会自动生成供Claude使用的JSON Schema。
• 工具定义通过使用 MCP. tool 装饰器或方法来实现。
• 所有文档数据初始存储在内存中的 docs 字典中（键为文档ID）。
• 文档工具（读取/编辑）的实现逻辑均需检查文档ID是否存在于 docs 字典中，否则抛出 ValueError。