MCP Server Setup

🚀 MCP服务器项目

本项目提供了一个MCP（Multi - Capability Provider）服务器的实现，可通过多种方式运行，并支持不同的传输协议，方便开发者进行测试、集成和部署。

🚀 快速开始

代码示例

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("DemoServer")

@mcp工具()
def say_hello(name: str) -> str:
    """向某人打招呼

    参数：
        name: 要打招呼的人的名字
    """
    返回 f"你好，{name}！见到你很高兴。"

if __name__ == "__main__":
    mcp运行()

📦 安装指南

运行服务器

有几种方法可以运行你的MCP服务器：

1. 开发模式与MCP检查器

测试服务器最简单的方法是使用MCP检查器：

mcp dev server.py

这将在本地运行你的服务器并与MCP检查器连接，这是一个基于网络的工具，可以直接让你与服务器的工具和资源交互。这对于测试非常有用。

2. Claude桌面集成

如果你安装了Claude Desktop，可以将服务器安装以便在Claude中使用：

mcp install server.py

这会将你的服务器添加到Claude Desktop的配置中，使其可供Claude使用。

3. 直接执行（仅限需要）

你也可以直接运行服务器：

# 方法1：作为Python脚本运行
python server.py

# 方法2：使用UV（推荐）
uv运行 server.py

💻 使用示例

基础用法

运行服务器示例

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("MyServer", host="127.0.0.1", port=8050)

# 在这里添加你的工具和资源...

if __name__ == "__main__":
    mcp以SSE传输运行()

高级用法

客户端实现示例

使用标准I/O的客户端

from subprocess import Popen, PIPE

# 启动服务器进程
server = Popen(["python", "server.py"], stdout=PIPE)

# 等待服务器准备完毕（实际实现中需要更复杂的握手）
input("按回车继续...")

# 调用say_hello工具
result = server.communicate(input=b'你好\n')

print(result)

使用SSE的客户端

import requests

# 连接SSE端点
response = requests.get('http://localhost:8050/sse', stream=True)

# 读取流数据
for line in response.iter_lines():
    如果 line:
        print(line.decode())

🔧 技术细节

运行MCP服务器时会发生什么？

当你运行一个MCP服务器时：

1. 服务器初始化为定义的能力（工具、资源等）
2. 开始侦听特定传输协议的连接

默认情况下，MCP服务器不使用传统的Web服务器端口。相反，它使用以下之一：

• 标准I/O传输：服务器通过标准输入和输出进行通信（mcp运行和与Claude Desktop集成时的默认值）
• SSE传输：基于HTTP的通信（当显式配置时）

如果你想通过HTTP在特定端口上暴露你的服务器，需要修改服务器以使用SSE传输。

比较两种传输方式

• 使用标准I/O：如果你的客户端和服务器将在同一进程或从客户端直接启动服务器进程时运行。
• 使用HTTP：如果你的服务器将在与客户端不同的位置运行，可能位于不同机器或容器中。

对于大多数生产后端集成，HTTP方法提供了更好的分离性和可扩展性，而标准I/O方法可能更适合开发或紧密结合的系统。