【如何自建MCP服务器？从协议原理到实践的全流程指南】

最新推荐文章于 2025-05-01 08:58:40 发布

TIF星空

最新推荐文章于 2025-05-01 08:58:40 发布

阅读量1.1k

点赞数 7

分类专栏： MCP 文章标签：服务器学习笔记经验分享 python ai

本文链接：https://blog.csdn.net/zsr154278963/article/details/147059461

版权

MCP 专栏收录该内容

1 篇文章

订阅专栏

如何自建MCP服务器？从协议原理到实践的全流程指南

一、MCP协议是什么？

模型上下文协议（Model Context Protocol, MCP） 是AI领域的一项革命性开放标准，由Anthropic推动，旨在解决大语言模型（LLM）与外部系统的集成难题。它类似于AI应用的"USB-C接口"，通过标准化协议让AI模型能够动态访问本地/远程数据源、工具和API，实现真正的"即插即用"能力。

核心架构

MCP Host：如Claude Desktop、Cursor等客户端程序
MCP Client：客户端内的中间件，管理服务器连接
MCP Server：提供特定功能的轻量级服务程序
数据源：本地文件/数据库或远程API/服务

二、为什么要自建MCP服务器？

1. 突破LLM的固有局限

让模型具备实时获取天气、访问数据库、执行计算等能力，解决"时间盲区"、"数据孤岛"等问题。

2. 实现个性化功能扩展

连接企业内部系统（如ERP、CRM）
集成特定领域工具（如科研计算、金融数据分析）
开发私有化服务（如内部知识库查询）

3. 确保数据隐私安全

敏感数据保留在本地环境，通过协议级权限控制实现安全访问

三、手把手搭建MCP服务器（Python示例）

环境准备

Python 3.10+：推荐使用conda管理环境

包管理器：安装uv（更快的Python包管理工具）

winget install --id=astral-sh.uv -e  # Windows
brew install uv                       # Mac

依赖库：
```
uv add mcp[cli] httpx python-dotenv
```

步骤1：创建天气查询服务器

# weather_server.py
from mcp.server.fastmcp import FastMCP
import httpx
from pydantic import BaseModel

mcp = FastMCP("WeatherService", host="0.0.0.0", port=9000)

class WeatherRequest(BaseModel):
    city: str = Field(..., description="查询城市名称")

@mcp.tool()
async def get_weather(request: WeatherRequest) -> str:
    """获取实时天气数据"""
    async with httpx.AsyncClient() as client:
        response = await client.get(
            f"https://api.openweathermap.org/data/2.5/weather",
            params={
                "q": request.city,
                "appid": "YOUR_API_KEY",
                "units": "metric"
            }
        )
        data = response.json()
        return f"{request.city}气温：{data['main']['temp']}°C，天气：{data['weather'][0]['description']}"

if __name__ == "__main__":
    mcp.run(transport='sse')

步骤2：配置运行参数

# 启动服务器（支持SSE长连接）
python weather_server.py

步骤3：部署扩展（可选）

本地运行：直接通过命令行启动
Docker部署：构建镜像实现跨平台运行
Serverless架构：部署到腾讯云函数等平台实现弹性扩展

四、MCP服务器的使用实践

1. 客户端配置（以Claude Desktop为例）

修改配置文件%APPDATA%\Claude\claude_desktop_config.json：

{
  "mcpServers": {
    "weather": {
      "command": "python",
      "args": ["/path/to/weather_server.py"],
      "env": {"OPENWEATHER_API_KEY": "your_key"}
    }
  }
}

2. 典型使用场景

自然语言交互：

用户：“上海现在的气温多少？”
Claude：“正在调用天气服务… 上海当前气温25°C，多云天气”

数据查询：

SELECT * FROM products WHERE price < 100  # 通过SQLite MCP服务器查询本地数据库

工作流集成：

/generate_report 使用天气数据+销售数据生成周报

五、进阶开发技巧

1. 多工具集成

@mcp.tool()
def calculate(data: str):
    """执行数学计算"""
    return eval(data)

@mcp.resource("note://{title}")
def read_note(title: str):
    """读取本地笔记"""
    with open(f"notes/{title}.md") as f:
        return f.read()