前言说白了MCP 这个东西火了大半年了但很多开发者还停留在听过但没用过的阶段。今天这篇就一个目的带你从零写一个 MCP Server然后用 Claude 调用它。整个过程不超过 30 分钟。先说清楚 MCP 是干嘛的。你可以把它理解成 AI 模型和外部工具之间的USB 接口——以前每个 AI 应用都要自己写一套工具调用逻辑现在有了统一标准工具写一次到处能用。环境准备你需要这几样东西Python 3.10推荐 3.12uv 包管理器比 pip 快太多强烈推荐一个 Anthropic API Key安装 uv# macOS / Linuxcurl-LsSfhttps://astral.sh/uv/install.sh|sh# Windowspowershell-cirm https://astral.sh/uv/install.ps1 | iex创建项目uv init mcp-server-democdmcp-server-demo uvaddmcp anthropic写一个最简单的 MCP Server直接上代码。这个 Server 提供一个get_weather工具返回模拟天气数据# server.pyfrommcp.server.fastmcpimportFastMCP mcpFastMCP(weather-server)mcp.tool()asyncdefget_weather(city:str)-str:获取指定城市的天气信息# 这里用模拟数据实际项目可以接真实 APImock_data{北京:晴28°C湿度 45%,上海:多云26°C湿度 65%,深圳:雷阵雨30°C湿度 80%,}returnmock_data.get(city,f{city}暂无数据)mcp.tool()asyncdeflist_cities()-str:返回支持查询的城市列表return北京、上海、深圳if__name____main__:mcp.run(transportstdio)就这么多。没错MCP Server 的核心就是这么简洁。装饰器mcp.tool()会自动把函数注册为工具函数的 docstring 就是工具的描述——Claude 会根据这个描述决定什么时候调用它。用 Claude Desktop 测试打开 Claude Desktop 的配置文件# macOSvim~/Library/Application\Support/Claude/claude_desktop_config.json# Windowsnotepad %APPDATA%\Claude\claude_desktop_config.json加入你的 Server{mcpServers:{weather:{command:uv,args:[run,python,server.py],cwd:你的项目路径}}}重启 Claude Desktop你会看到工具图标多了一个小锤子。试着问它北京天气怎么样——它会自动调用你的get_weather工具。进阶添加 Resource 和 PromptMCP 不只是工具调用它还有 Resource资源和 Prompt提示模板两个概念mcp.resource(config://app)asyncdefget_config():返回应用配置信息return{version:1.0,debug:False}mcp.prompt()asyncdefweather_report(city:str)-str:生成天气报告的提示模板returnf请根据以下信息为{city}生成一份简洁的天气报告包含出行建议。Resource 让 AI 能读取你的数据Prompt 让你能定义标准化的交互模板。常见问题QMCP Server 能用 TypeScript 写吗能而且官方 SDK 同时支持 Python 和 TypeScript。TypeScript 版用modelcontextprotocol/sdk这个包。Q除了 stdio还有别的通信方式吗有。MCP 还支持 SSEServer-Sent Events和 HTTP Streamable transport适合远程部署的场景。Q和 OpenAI Function Calling 有什么区别Function Calling 是 OpenAI 自己的标准绑定在 OpenAI 的 API 上。MCP 是开放标准任何模型都能用——DeepSeek、Gemini、本地模型都支持。Q安全性怎么保证MCP Server 运行在本地默认不暴露网络。如果要远程部署需要加上认证和权限控制。总结MCP 的核心价值就是标准化。以前每个 AI 应用都在重复造轮子现在大家用同一套协议工具生态可以共享。如果你在做 AI Agent 相关的开发MCP 几乎是必学的。下一步可以看看MCP 官方文档GitHub 上的 MCP Server 合集自己动手把现有的 API 封装成 MCP Server有问题评论区见
