如何设置MCP务器本文介绍了如何搭建基于 Python 和 `FastMCP` 的简单 `MCP` 服务器，用于连接 `

本文介绍了如何搭建基于 Python 和 FastMCP 的简单 MCP 服务器，用于连接 LLM 和开发者工具。通过 STDIO 协议，定义 secretword 工具，并演示了与 Claude Code 的集成。强调 MCP 作为 AI 和工具间通信标准的重要性，以及未来被库吸收的可能性。

译自：How To Set Up a Model Context Protocol Server

作者：David Eastman

在这篇文章中，我们将逐步介绍如何设置一个简单的模型上下文协议 (MCP)服务器。目前，MCP 是 LLM 模型和开发者工具之间进行通信的事实标准方式。您可以阅读我们更深入的 MCP 开发者入门以了解更多详情，但这篇文章并不假定您具备这些知识。

我假设您已经安装了 Claude Code，尽管我只是将其用作位于终端中的 LLM，方便进行实验。无论如何，您仍然可以继续学习。

为什么选择 MCP？

其基本思想是保持 AI 和开发者工具之间的连接分离。在我下面解释的工具脚本中，它只是一个位于其自身本地服务器中的 Python 方法，我所做的只是返回一个秘密词。当然，这样做是使用服务器来控制上下文，因为 LLM 不知道您的本地世界中存在什么，除非您告诉它们。当然，我们希望确保我们控制这种能力。

鉴于 Anthropic 创建了 MCP，您可能会认为其他 LLM 供应商会尝试他们自己类似的想法。我们知道 Microsoft 喜欢扩展、拥抱和消灭的策略，但似乎其他供应商已经开始支持 MCP。

像大多数连接组织一样，MCP 可能会随着时间的推移被其他工具吸收。因此，如果它真正成功，您将不再意识到它的存在。

了解您的传输方式

在我们的 MCP 开发者入门中，我们注意到两种协议之间的区别——STDIO，这意味着标准输入/输出，以及 SSE（现在是流传输），它更适合 Web。我们的工具只是一个简单的命令行界面 (CLI) 工具，因此它使用这种更简单的 STDIO 协议。通过“简单”，我们的意思是所有内容都在本地运行，没有额外的依赖项。

我们的 MCP 服务器和工具

首先，以熟悉的方式设置 Python 环境。我正在我的 MacBook 上执行此操作：

我们还需要安装 MCP 库：

我将脚本命名为 server.py。它结合了服务器和工具：

#!/usr/bin/env python3
from mcp.server.fastmcp import FastMCP
import time
import signal
import sys

# Handle SIGINT (Ctrl+C) gracefully
def signal_handler(sig, frame):
    print("Shutting down server gracefully...")
    sys.exit(0)

signal.signal(signal.SIGINT, signal_handler)

# Create an MCP server with increased timeout
mcp = FastMCP(
    name="secretword",
    host="127.0.0.1",
    port=5000,
    # Add this to make the server more resilient
    timeout=30  # Increase timeout to 30 seconds
)

# Define our tool
@mcp.tool()
def secretword() -> str:
    """Retuen the secret word"""
    try:
        return "ABRACADABRA"
    except Exception as e:
        # Return 0 on any error
        return ""

if __name__ == "__main__":
    try:
        print("Starting MCP server 'secretword' on 127.0.0.1:5000")
        # Use this approach to keep the server running
        mcp.run()
    except Exception as e:
        print(f"Error: {e}")
        # Sleep before exiting to give time for error logs
        time.sleep(5)

其中很大一部分是异常处理，因此我们只对大约 15 行代码感兴趣。我们使用 FastMCP 来定义一个简单的服务器，该服务器在端口 5000 上运行。我们通过信号处理程序处理 Ctrl-C。除此之外，我们的工具 secretword 只是一个返回单词“ABRACADABRA”的方法。我从 mberman84 的 gist 中改编了它。我希望您可以做一些更实质性的事情，但这证明了您也可以保持简单。

您可以通过直接运行它来测试它：