mcp-server-guide

---
name: mcp-server-guide
description: Set up and use an MCP (Model Context Protocol) server to give agents access to external tools or data. 搭建并使用 MCP 服务器扩展 agent 能力。
---

# MCP Server Guide | MCP 服务器搭建

Set up a small MCP server so an agent can call your tools / read your data through the Model Context Protocol.

让 agent 通过 MCP 协议调用你的工具或读取你的数据。

## When to use | 适用场景
- 用户想把 agent 接上自己的 API、数据库或本地文件
- 需要给 agent 新增一个自定义工具

## Workflow | 工作流程
1. 明确要暴露什么（一个查询接口 / 一个数据源 / 一个计算函数）。
2. 选语言：Python（`mcp` 包）或 TypeScript（`@modelcontextprotocol/sdk`）。
3. 用 `add_tool` 注册工具，写好参数 schema 和说明（说明越清晰 agent 越会用）。
4. 本地 `mcp dev` 调试，确认工具能调通。
5. 在客户端配置里注册 server，重启后让 agent 调用验证。

## Tips | 提示
- 工具描述写清「何时用 + 参数含义」，效果远好于只写函数名。
- 先只暴露必要的最小权限，再逐步放开。