🚀 MCP Python SDK 文档

MCP Python SDK 用于连接大语言模型 (LLM)，借助 MCP 协议，可将应用与 LLM 集成，为用户带来更强大的交互体验。

🚀 快速开始

MCP（Model Context Protocol）是一个用于连接大语言模型 (LLM) 的协议。通过 MCP，你可以将你的应用与 LLM 集成，为用户提供更强大的交互体验。

示例：创建一个基本的 MCP 服务器

from mcp import ServerSession, StdioServerParameters, types
from mcp.server.stdio import stdio_server

async def run():
    async with stdio_server() as (read_stream, write_stream):
        async with ServerSession(
            read_stream,
            write_stream,
            initialization_options=types.InitializationOptions(
                server_name="my-server",
                server_version="1.0.0",
                capabilities=server.get_capabilities(),
            ),
        ) as session:
            await session.run()

if __name__ == "__main__":
    import asyncio

    asyncio.run(run())

📦 安装指南

安装

要安装 MCP Python SDK，请运行以下命令：

pip install mcp-sdk

💻 使用示例

基础用法

示例：创建一个提供文件资源的服务器

from mcp import ServerSession, StdioServerParameters, types
from mcp.server.stdio import stdio_server

async def handle_list_prompts() -> list[types.Prompt]:
    return []

async def handle_get_prompt(name: str, arguments: dict[str, str] | None) -> types.GetPromptResult:
    raise ValueError(f"Unknown prompt: {name}")

async def run():
    async with stdio_server() as (read_stream, write_stream):
        async with ServerSession(
            read_stream,
            write_stream,
            initialization_options=types.InitializationOptions(
                server_name="my-server",
                server_version="1.0.0",
                capabilities=server.get_capabilities(),
            ),
        ) as session:
            await session.run()

if __name__ == "__main__":
    import asyncio

    asyncio.run(run())

高级用法

示例：编写 MCP 客户端

from mcp import ClientSession, StdioClientParameters, types
from mcp.client.stdio import stdio_client

async def run():
    async with stdio_client() as (read_stream, write_stream):
        async with ClientSession(
            read_stream,
            write_stream,
            connection_options=types.ConnectionOptions(),
        ) as session:
            await session.run()

if __name__ == "__main__":
    import asyncio

    asyncio.run(run())

📚 详细文档

MCP 协议的核心概念

MCP 定义了三个核心概念：

MCP 服务器功能

MCP 服务器在初始化时会声明其功能：

创建一个提供文件资源的服务器步骤

步骤 1: 安装依赖

pip install mcp-sdk

步骤 2: 创建服务器代码

from mcp import ServerSession, StdioServerParameters, types
from mcp.server.stdio import stdio_server

async def handle_list_prompts() -> list[types.Prompt]:
    return []

async def handle_get_prompt(name: str, arguments: dict[str, str] | None) -> types.GetPromptResult:
    raise ValueError(f"Unknown prompt: {name}")

async def run():
    async with stdio_server() as (read_stream, write_stream):
        async with ServerSession(
            read_stream,
            write_stream,
            initialization_options=types.InitializationOptions(
                server_name="my-server",
                server_version="1.0.0",
                capabilities=server.get_capabilities(),
            ),
        ) as session:
            await session.run()

if __name__ == "__main__":
    import asyncio

    asyncio.run(run())

步骤 3: 运行服务器

python your_server_script.py

🤝 贡献指南

如何贡献代码

1. Fork 项目仓库
2. 创建功能分支
3. 提交代码更改
4. 创建 Pull Request

📄 许可证

本项目采用 Apache 2.0 许可证。