Redbook Search Comment MCP

🚀 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 許可證。