⚙️ MCP Server开发实践

📌 一句话概括

MCP Server开发是将现有API和数据源"封装"成模型可调用的工具——关键在于定义清晰、鲁棒的Tool Schema。

💡 开发模式

① Python SDK

from mcp.server import Server, stdio_server

@server.tool()
async def query_database(sql: str) -> str:
    # 执行SQL查询
    return result

② TypeScript SDK

import { Server } from "@modelcontextprotocol/sdk";

🔍 测试实战

1. MCP Server集成测试

操作：在Hermes/Claude Code中配置MCP Server，验证工具调用

工具：hermes mcp add my-server --command "python server.py"

2. 工具错误场景测试

操作：构造异常输入，验证Server返回有意义的错误信息

⚠️ 常见坑点

1. 工具参数描述不够清晰——模型不知道参数该怎么填
2. Server中嵌入了API Key等敏感信息
3. Tool返回数据量过大未做截断——撑爆模型上下文