连接 mcp 服务器

不同于 Claude Desktop 和其他的 MCP 客户端类产品，OpenMCP 进行 MCP 服务器连接的步骤是相当丝滑的。

:::info MCP客户端 MCP 客户端是指能够通过 MCP 协议进行通信的大模型对话客户端，通常是一个运行在本地的应用程序（因为网页没有文件IO的权限）。它的产品形式目前几乎都是聊天机器人的形式，类似于你在网页使用的 chat.deepseek.com 或者 chat.openai.com :::

https://kirigaya.cn/openmcp/plugin-tutorial/acquire-openmcp.html

首先，打开你的 VLE，在获取 OpenMCP 中完成 OpenMCP 的安装后，我们先用 python 创建一个最简单的 mcp 服务器，来测试 mcp 客户端的连接。

安装 uv

Python 写 mcp 服务器强烈推荐使用 uv 作为包管理器，关于 uv，你只需要知道它是一个高性能包管理器，拥有 pip 和 conda 的所有优点。没有的朋友请先通过 pip 安装 uv：

pip install uv

:::warning 使用 anaconda 或者 miniconda 的朋友注意了！请不要在非 base 环境下安装 uv，请在 base 环境下安装 uv，uv 本身会做好环境隔离的工作，请不要担心 uv 会污染你的 base 环境。你不安装在 base 下或者使用全局默认的 pip 安装，我们根本不知道你安装的 uv 在哪里！base 环境下使用 pip 安装的脚本会安装在 ~/anaconda/bin/uv 中，也请确保 ~/anaconda/bin/ 在你的 $PATH 中。 :::

查看 uv 的版本：

uv version

我的输出是：

uv 0.6.9 (3d9460278 2025-03-20)

实操时，请保证版本不要低于我的。

创建一个最简单的 mcp 服务器

我们进入工程目录，准备创建一个最简单的 mcp 服务器。

mkdir -p ~/codes/python && cd ~/codes/python
uv init --no-workspace

此时，你的项目里面应该有这三个文件：

README.md      main.py        pyproject.toml

然后，我们在当前文件夹打开 vscode 或者 trae，我们创建一个最简单的 mcp 服务器，它的功能是：

提供一个名为 add 的工具，用于对两个数字进行加法
提供一个名为 greeting 的资源，用于返回一个 greeting 消息

先安装 mcp 相关的库：

uv add mcp "mcp[cli]"

修改 main.py 内容如下：

from mcp.server.fastmcp import FastMCP
mcp = FastMCP('锦恢的 MCP Server', version="11.45.14")

@mcp.tool(
    name='add',
    description='对两个数字进行实数域的加法'
)
def add(a: int, b: int) -> int:
    return a + b

@mcp.resource(
    uri="greeting://{name}",
    name='greeting',
    description='用于演示的一个资源协议'
)
def get_greeting(name: str) -> str:
    return f"Hello, {name}!"

@mcp.prompt(
    name='translate',
    description='进行翻译的prompt'
)
def translate(message: str) -> str:
    return f'请将下面的话语翻译成中文：\n\n{message}'

使用 OpenMCP 一键连接

如上，我们申明了三个函数，用作 mcp 的 tool，resource 和 prompt。在 OpenMCP 中启动它们非常简单，点击右上角的 OpenMCP 图标即可连接：

初次使用 OpenMCP，会出现引导界面，还希望阁下可以耐心看完。

如果登录完成后，如图显示连接成功，则代表当前已经成功启动并连接 mcp 服务器。

恭喜您，万事开头难，您已经完成了最难的 mcp 连接！

附录：关于 uv 启动 mcp 你必须知道的

OpenMCP 已经帮你做好了很多事情，但是使用 uv 启动 mcp 服务器其实是不只一种方法的，了解更加底层的原理有助于您以不变应万变。因为 OpenMCP 对于 python 项目默认运行 uv run mcp run main.py 来启动 mcp 服务器，但是 GitHub 上的部分项目无法这么启动。

先了解一下正常的如下的代码应该如何通过命令行启动 mcp 吧！

from mcp.server.fastmcp import FastMCP
mcp = FastMCP('锦恢的 MCP Server', version="11.45.14")

@mcp.tool(
    name='add',
    description='对两个数字进行实数域的加法'
)
def add(a: int, b: int) -> int:
    return a + b

@mcp.resource(
    uri="greeting://{name}",
    name='greeting',
    description='用于演示的一个资源协议'
)
def get_greeting(name: str) -> str:
    return f"Hello, {name}!"

@mcp.prompt(
    name='translate',
    description='进行翻译的prompt'
)
def translate(message: str) -> str:
    return f'请将下面的话语翻译成中文：\n\n{message}'

方法一：使用 mcp-cli

mcp 本身提供了脚手架，可以直接启动一段被申明的 python 代码，作为一个 mcp 服务器。使用如下代码运行它：

uv run mcp run main.py

方法二：在代码中显式启动

你也可以在代码中显式启动 mcp 服务器，在 main.py 的结尾添加：

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

然后运行如下代码即可启动 mcp 服务器：

uv run main.py

:::warning 请不要运行 python main.py，因为 uv run 会使用当前虚拟环境的库，这些库在外部 python 看来是不可见的。也不要在没有使用 mcp.run() 启动代码的情况下就直接使用 mcp run main.py，我们之前的代码只是申明了函数，并没有实际上执行任何功能。 :::

5.3 KiB Raw Blame History Unescape Escape