Defining tools with MCP

MCP 服务器与工具实现要点

• MCP 服务器目标： 为命令行界面 (CLI) 聊天机器人添加额外的功能，通过 MCP 服务器实现工具调用。
• 核心技术： 使用官方的 MCP Python SDK。
• 优势： SDK 简化了服务器的创建（仅需一行代码）和工具的定义过程。
• 工作原理： 开发者定义工具的名称、描述和参数，SDK 会自动生成工具所需的 JSON Schema，供 Claude 使用。
• 工具定义流程：
• 定义工具名称 (e. g. , read_doc_contents)。
• 提供工具描述（应清晰说明何时使用该工具）。
• 定义工具函数，并使用 pydantic. field 等机制指定参数及其类型。
• 工具一：读取文档 (Read Document)
• 功能： 根据文档 ID (doc ID) 返回文档内容。
• 实现逻辑： 在内存中的 docs 字典中查找对应的键 (doc ID) 并返回其值。
• 错误处理： 若提供的 doc ID 不存在于 docs 字典中，则抛出 ValueError。
• 工具二：编辑文档 (Edit Document)
• 功能： 在文档内容中执行“查找并替换”操作。
• 所需参数：
• doc_id (文档 ID)
• old_string (需要替换的旧文本)
• new_string (替换后的新文本)
• 实现逻辑： 找到目标文档后，执行 replace 操作。
• 错误处理： 若 doc ID 不存在，则抛出 ValueError。
• 总结： 使用 MCP SDK 极大地简化了工具的定义过程，无需手动编写复杂的 JSON Schema。

Takeaways

• MCP服务器的目标是为命令行界面 (CLI) 聊天机器人添加工具调用功能。
• 核心技术是MCP Python SDK，它极大地简化了服务器创建和工具定义的复杂过程。
• 工具定义流程包括指定工具名称、清晰的描述以及使用 pydantic. field 等机制定义参数和类型。
• SDK 的关键优势在于它能自动生成工具所需的 JSON Schema，供 Claude 使用，无需手动编写。
• 工具实现（如读取或编辑文档）需在代码中处理错误，例如当提供的文档 ID 不存在时抛出 ValueError。