微软开源的 MCP 入坑笔记

22次阅读
没有评论

共计 1259 个字符,预计需要花费 4 分钟才能阅读完成。

快速入口

  • 仓库主页(课程大纲、示例与活动一站式):microsoft/mcp-for-beginners。含多语言页面与学习指引。(GitHub)
  • 官方中文翻译(持续自动同步):translations/zh/README.md。(GitHub)

学什么(官方课程结构,精简版)

  • 模块 1–3:基础(概念、安全、环境准备与“第一个 Server/Client”)
  • 模块 3.x:动手做(首个 Server/Client、接入 LLM、VS Code 集成、stdio 与 HTTP 流、部署与鉴权)
  • 模块 4–5:实践 / 进阶(SDK 调试测试、Azure 集成、多模态、OAuth、Root Context、路由、采样、可扩展性与安全)
  • 模块 11:Hands-on Lab(13 个实验):从数据库设计、FastMCP 实现、向量检索、监控到生产最佳实践的完整路径。
    这些条目在仓库 README 的课程表里都有直达链接。(GitHub)

3 步跑通一个最小 MCP(Python)

下面用 官方 Python SDK(内置 FastMCP)做“加法器”Server,确保能在本地被 MCP 客户端 / 检查器连接。

  1. 安装 SDK 与 CLI
# 用 pip
pip install "mcp[cli]"

# 或用 uv(官方推荐)uv init mcp-demo && cd mcp-demo
uv add "mcp[cli]"

(命令来源:官方 Python SDK README 的 Installation/Quickstart。)(GitHub)

  1. 新建 server.py(极简示例)
from mcp.server.fastmcp import FastMCP

mcp = FastMCP("Demo")

@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b

(示例思路与 API 见 Python SDK Quickstart/ 示例片段。)(GitHub)

  1. 本地调试 / 检查
# 使用 MCP Inspector(开发调试)mcp dev server.py

# 若使用 uv 运行 CLI:uv run mcp dev server.py

(同样出自 SDK README:mcp dev/mcp install 等开发工具。)(GitHub)

想在桌面客户端里用(如 Claude Desktop),可按 SDK 文档把该 server 安装到客户端;想在 VS Code 里消费 MCP 服务器,可对照课程中的“VS Code Integration”。(GitHub)

进阶与生产

  • Azure/ 部署 / 监控 / 安全:课程提供 Azure 集成、容器化部署(如 Azure Container Apps)、Application Insights 监控与安全加固等专题及 Lab。(GitHub)
  • 更多语言示例:仓库列出了 C#/Java/TS/JS/Rust/Python 的“计算器”等样例,便于跨语言对照。(GitHub)

官方生态 / 文档

  • MCP 文档与规范(课程页内置入口,含教程与技术参考)。(GitHub)
  • Python SDK 文档(完整 API/ 传输 / 客户端与鉴权示例)。(GitHub)

正文完
 0
一诺
版权声明:本站原创文章,由 一诺 于2025-09-20发表,共计1259字。
转载说明:除特殊说明外本站文章皆由CC-4.0协议发布,转载请注明出处。
评论(没有评论)
验证码