【亲测免费】 Model Context Protocol (MCP) Python SDK 使用教程

1. 项目介绍

Model Context Protocol (MCP) Python SDK 是一款开源的 Python 库，用于实现 MCP 协议。MCP 协议允许应用程序以一种安全、标准化的方式为大型语言模型（LLM）提供上下文信息，从而将提供上下文的职责与 LLM 的实际交互分离。通过使用这个 SDK，开发者可以轻松构建 MCP 客户端和服务器，以支持在 LLM 应用程序中的数据传输和功能调用。

2. 项目快速启动

以下是快速启动 MCP Python SDK 的步骤：

首先，确保你已经安装了 Python。然后，通过以下命令安装 MCP SDK：

pip install mcp

接下来，创建一个名为 server.py 的 Python 文件，并编写以下代码以启动一个简单的 MCP 服务器：

from mcp.server.fastmcp import FastMCP

# 创建一个 MCP 服务器实例
mcp_server = FastMCP("我的应用")

# 添加一个简单的加法工具
@mcp_server.tool()
def add(a: int, b: int) -> int:
    """计算两个数的和"""
    return a + b

# 添加一个动态的问候资源
@mcp_server.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """获取个性化的问候信息"""
    return f"你好，{name}！"

# 运行服务器
if __name__ == "__main__":
    mcp_server.run()

使用以上代码，你可以启动一个包含加法工具和问候资源的 MCP 服务器。

3. 应用案例和最佳实践

Echo Server

一个简单的 Echo 服务器可以用来回显发送到它的任何消息。这可以用于测试 MCP 服务器是否正常工作。

from mcp.server.fastmcp import FastMCP

@mcp_server.tool()
def echo(message: str) -> str:
    """回显发送的消息"""
    return message

SQLite Explorer

创建一个 MCP 服务器，允许用户通过 MCP 协议查询 SQLite 数据库。

import sqlite3
from mcp.server.fastmcp import FastMCP

@mcp_server.tool()
def query_db(query: str) -> str:
    """执行 SQL 查询并返回结果"""
    conn = sqlite3.connect('example.db')
    cursor = conn.cursor()
    cursor.execute(query)
    result = cursor.fetchall()
    cursor.close()
    conn.close()
    return str(result)

低级服务器使用

对于更高级的使用场景，可以直接使用 MCP 协议的低级服务器接口，以更细粒度地控制服务器的行为。

4. 典型生态项目

目前，围绕 MCP Python SDK 已经有一些生态项目正在开发中。以下是一些典型的例子：

• MCP Inspector：一个用于测试和调试 MCP 服务器的工具。
• MCP CLI：一个命令行工具，用于与 MCP 服务器交互。
• MCP GUI：一个图形用户界面，提供直观的方式来管理 MCP 服务器和资源。

这些项目扩展了 MCP Python SDK 的功能，使其能够更好地服务于各种不同的应用场景。