MCP服务器新手教程2026

现在每个AI工具都提MCP，但没人从零讲起。

💡 你将学到

现在每个AI工具都提MCP，但没人从零讲起。

📜 目录

• MCP 服务器初学者教程 2026：从零到你的第一个 AI 工具集成
• 你将构建什么
• 第一步：理解三个角色
• 第二步：编写服务器
• 第三步：在 Claude Desktop 中注册
• 第四步：使用它
• 初学者常见错误
• 常见问题
• 相关文章

MCP 服务器初学者教程 2026：从零到你的第一个 AI 工具集成

本教程假设你从未听说过 MCP，并希望通过动手实践来理解它。学完本教程后，你将成功将 AI 助手连接到真实的外部工具。

你将构建什么

一个 MCP 服务器，让 Claude Desktop 能够读取本地待办事项列表。当你问“我的待办事项列表上有什么？”时，Claude 会调用你的服务器，读取文件，然后回答你。

第一步：理解三个角色

• MCP 客户端 — AI 助手（Claude Desktop、Cline 等）
• MCP 服务器 — 一个封装工具或数据源的小程序
• 传输层 — 它们之间的通信方式（本机使用 stdio，网络使用 HTTP）

第二步：编写服务器

创建 todo_server.py：

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("Todo Server")

@mcp.tool()
def add_todo(item: str) -> str:
    with open("todos.txt", "a") as f:
        f.write(item + "
")
    return f"已添加：{item}"

@mcp.tool()
def list_todos() -> str:
    try:
        with open("todos.txt") as f:
            return f.read() or "空"
    except FileNotFoundError:
        return "空"

第三步：在 Claude Desktop 中注册

1. 打开 Claude Desktop > 设置 > 开发者
2. 点击“编辑配置”，添加服务器，命令为 python，参数指向你的脚本
3. 重启 Claude Desktop

第四步：使用它

输入：“把买牛奶添加到我的待办事项列表，然后显示列表。”

Claude 会先调用 add_todo，再调用 list_todos，然后根据文件内容回答你。无需提示工程，无需胶水代码——协议已经完成了所有连接工作。

初学者常见错误

常见问题

我需要会编程吗？ 对于本教程，复制粘贴就够了。要构建生产级服务器，你需要基础的 Python 或 TypeScript 知识。

MCP 只能本地使用吗？ 不是——服务器可以通过 HTTP/SSE 远程运行，SaaS 工具正是通过这种方式向 AI 开放数据。

使用成本是多少？ 协议和 SDK 完全免费且开源。

相关文章

• 什么是MCP服务器？2026年新手解释
• Open WebUI教程：最好看的本地AI聊天界面
• 2026年开源个人AI助手：Open WebUI（14.8万星）对比 Khoj 与 chatbot-ui，你的私密Siri替代品

❓ 常见问题

Do I need to know programming?

For this tutorial, copy-paste is enough. To build production servers you need basic Python or TypeScript.

Is MCP only for local use?

No - servers can run remotely over HTTP/SSE, which is how SaaS tools expose their data to AI.

How much does it cost?

The protocol and SDK are free and open source.