test webhook

plugin-tutorial/concept.md

@@ -272,7 +272,7 @@ Tools 端将会是我们后面调试的核心。在之前的章节我们讲过
 
 
 
-## 结余
+## 结语
 
 这篇文章，我们简单了解了 MCP 内部的一些基本概念，我认为这些概念对于诸位开发一个 MCP 服务器是大有裨益的，所以我认为有必要先讲一讲。
 

plugin-tutorial/usage/connect-mcp.md

@@ -8,9 +8,159 @@ MCP 客户端是指能够通过 MCP 协议进行通信的大模型对话客户
 
 首先，打开你的 VLE，在 [获取 OpenMCP](https://kirigaya.cn/openmcp/plugin-tutorial/acquire-openmcp.html) 中完成 OpenMCP 的安装后，我们先用 python 创建一个最简单的 mcp 服务器，来测试 mcp 客户端的连接。
 
-:::tip 提示
+
-Python 写 mcp 服务器强烈推荐使用 uv 作为包管理器
+## 安装 uv
+
+Python 写 mcp 服务器强烈推荐使用 uv 作为包管理器，关于 uv，你只需要知道它是一个高性能包管理器，拥有 pip 和 conda 的所有优点。没有的朋友请先通过 pip 安装 uv：
+
+```bash
+pip install uv
+```
+
+:::warning 使用 anaconda 或者 miniconda 的朋友注意了！
+请不要在非 base 环境下安装 uv，请在 base 环境下安装 uv，uv 本身会做好环境隔离的工作，请不要担心 uv 会污染你的 base 环境。你不安装在 base 下或者使用全局默认的 pip 安装，我们根本不知道你安装的 uv 在哪里！base 环境下使用 pip 安装的脚本会安装在 `~/anaconda/bin/uv` 中，也请确保 `~/anaconda/bin/` 在你的 `$PATH` 中。
 :::
 
 
-<mark>awdwadwa</mark>
+查看 uv 的版本：
+
+```bash
+uv version
+```
+
+我的输出是：
+```
+uv 0.6.9 (3d9460278 2025-03-20)
+```
+
+实操时，请保证版本不要低于我的。
+
+## 创建一个最简单的 mcp 服务器
+
+我们进入工程目录，准备创建一个最简单的 mcp 服务器。
+
+```bash
+mkdir -p ~/codes/python && cd ~/codes/python
+uv init --no-workspace
+```
+
+此时，你的项目里面应该有这三个文件：
+
+```
+README.md      main.py        pyproject.toml
+```
+
+然后，我们在当前文件夹打开 vscode 或者 trae，我们创建一个最简单的 mcp 服务器，它的功能是：
+- 提供一个名为 add 的工具，用于对两个数字进行加法
+- 提供一个名为 greeting 的资源，用于返回一个 greeting 消息
+
+先安装 mcp 相关的库：
+
+```bash
+uv add mcp "mcp[cli]"
+```
+
+修改 `main.py` 内容如下：
+
+```python
+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 的 tool，resource 和 prompt。在 OpenMCP 中启动它们非常简单，点击右上角的 OpenMCP 图标即可连接：
+
+![](./images/connect-simple.png)
+
+初次使用 OpenMCP，会出现引导界面，还希望阁下可以耐心看完。
+
+![](./images/guide.png)
+
+如果登录完成后，如图显示连接成功，则代表当前已经成功启动并连接 mcp 服务器。
+
+![](./images/connect-success.png)
+
+恭喜您，万事开头难，您已经完成了最难的 mcp 连接！
+
+## 附录：关于 uv 启动 mcp 你必须知道的
+
+OpenMCP 已经帮你做好了很多事情，但是使用 uv 启动 mcp 服务器其实是不只一种方法的，了解更加底层的原理有助于您以不变应万变。因为 OpenMCP 对于 python 项目默认运行 `uv run mcp run main.py` 来启动 mcp 服务器，但是 GitHub 上的部分项目无法这么启动。
+
+先了解一下正常的如下的代码应该如何通过命令行启动 mcp 吧！
+
+
+```python
+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 服务器。使用如下代码运行它：
+
+```bash
+uv run mcp run main.py
+```
+
+## 方法二：在代码中显式启动
+
+你也可以在代码中显式启动 mcp 服务器，在 `main.py` 的结尾添加：
+
+```python
+if __name__ == '__main__':
+    mcp.run()
+```
+
+然后运行如下代码即可启动 mcp 服务器：
+
+```bash
+uv run main.py
+```
+
+:::warning
+请不要运行 python main.py，因为 uv run 会使用当前虚拟环境的库，这些库在外部 python 看来是不可见的。也不要在没有使用 `mcp.run()` 启动代码的情况下就直接使用 mcp run main.py，我们之前的代码只是申明了函数，并没有实际上执行任何功能。
+:::
+