MCP模型上下文协议服务器开发快速入门教程

在AI应用飞速发展的当下，大型语言模型（LLM）的应用场景正不断拓展。为了让LLM更好地整合数据和工具，MCP（Model Context Protocol）应运而生。今天，我们就来详细了解一下如何开发一个MCP服务器。

一、准备工作

在开始之前，你需要具备一些基础知识和系统要求：

基础知识：熟悉Python以及LLM（如Claude）的相关知识。
系统要求：安装Python 3.10或更高版本，并使用Python MCP SDK 1.2.0或更高版本。

二、搭建环境

首先，我们需要安装uv并设置Python项目环境：

pip install uv

确保安装完成后重启终端，以便正确识别uv命令。

接下来，创建并设置项目：

mkdir weather_server
cd weather_server

三、构建服务器

导入包并设置实例

在weather.py文件顶部添加以下代码：

from fastmcp import FastMCP


mcp = FastMCP()

FastMCP类利用Python类型提示和文档字符串自动生成工具定义，方便我们创建和维护MCP工具。

添加辅助函数

然后，添加查询和格式化数据的辅助函数。这里，我们以美国国家气象局API为例：

import requests


def get_weather_data(location):
    # 这里是向国家气象局API发送请求的代码
    # 响应数据将从API返回
    pass


def format_weather_data(data):
    # 这里是格式化天气数据的代码
    pass

实现工具执行

工具执行处理器负责执行每个工具的逻辑。我们继续添加：

@mcp.tool()
def get_current_weather(location):
    """获取当前位置的天气情况"""
    weather_data = get_weather_data(location)
    return format_weather_data(weather_data)

运行服务器

最后，初始化并运行服务器：

if __name__ == "__main__":
    mcp.run()

现在，你的服务器已经构建完成！运行uv run weather.py来确认一切正常。

四、测试服务器

我们可以使用Claude for Desktop来测试服务器。

首先，确保已安装Claude for Desktop。若未安装，可从官网下载最新版本。若已安装，请确保它是最新版本。
打开Claude for Desktop的配置文件claude_desktop_config.json，通常位于~/Library/Application Support/Claude/目录下。如果文件不存在，则需要创建它。
在配置文件中添加MCP服务器信息。例如：

{
  "mcpServers": [
    {
      "name": "weather",
      "launchCommand": "uv --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/weather run weather.py"
    }
  ]
}

保存文件后，重启Claude for Desktop。

通过上述步骤，你就成功搭建并测试了一个简单的MCP服务器。在编程狮（W3Cschool.cn）平台，你可以找到更多关于MCP开发的实例和教程，帮助你进一步提升开发技能。