MCP初入门

原创已于 2025-09-02 12:35:36 修改 · 865 阅读

11 ·

CC 4.0 BY-SA版权

文章标签：

#MCP

于 2025-09-01 21:04:31 首次发布

最近MCP很火，大概了解了一下，Model Context Protocol, 模型上下文协议，可以理解为大模型间的连接器，保证大模型工具间的连接。详细文字说明自行google，在此不多文字赘述。

所有内容是根据自己理解打出来，不是copy的，如果有认识和理解上的不一致，请指出，一块探讨，共同进步。

下面记录一下最简单的一个DEMO流程：搭建MCP服务器，以及如何从前端调用MCP提供的服务。

总体来讲，一个完整的Agent系统包含3部分：(1)前端与客户的交互；（2）大模型部分：将客户文本解析，抽取出需要调用的功能；（3）MCP Server: 告诉大模型这些功能去哪里调用。下面分开来说

1. 搭建自己本地的一个MCP Server

MCP Server支持TypeScript 和 Python . 我用python较多，所以选择了 python的SDK。

(1) 创建mcp虚拟环境

mcp server 最好python > 3.12

conda create --name mcp python=3.12

conda activate mcp

(2) 安装uv

首先需要安装uv，用来管理python项目 pip install uv

安装完成后查看是否安装成功

uv -version

(mcp) D:\mydocs\git_src\mcp_python-sdk>uv --version
uv 0.8.14 (af856fb88 2025-08-28)

(3) MCP Service

MCP Service包括几个部分：Resource / Tools / Prompts / ....

可以通过一个example 查看：uv run mcp dev examples/fastmcp/screenshot.py

在下面的例子中，有加法工具，乘法工具，其中注释是告诉大模型这个方法是做什么有什么功能，供大模型自动调用

from mcp.server.fastmcp import FastMCP

# Create an MCP server
mcp = FastMCP("Demo")


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

@mcp.tool()
def multiple(a:int, b:int)->int:
    '''test multiple function'''
    return a*b

@mcp.tool()
def echo(content: str)->str:
    """this is echo"""
    return content

@mcp.resource("echo://{text}")
def echo_resource(text):
    return f"echo: {text}"

# Add a dynamic greeting resource
@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """Get a personalized greeting"""
    return f"Hello, {name}!"

@mcp.resource("dir://desktop")
def list_desktop():
    from pathlib import Path

    dir = Path.home() / "Desktop"
    return [str(f) for f in dir.iterdir()]


if __name__=="__main__":
    print('start mcp server stdio')
    mcp.run(transport="stdio")