docs(ecosystem): update MCP Client documentation with usage instructions and configuration examples

- Added detailed usage instructions for the MCP Client plugin, including server configuration examples.
- Included new images to illustrate the configuration process.
- Updated existing documentation to clarify the requirements for using the plugin mode in ChatLuna.

Author: dingyi222666

.cursor/settings.json

@@ -0,0 +1,15 @@
+{
+    "cSpell.words": [
+        "Dify",
+        "newbing",
+        "Ollama",
+        "onappear",
+        "Redisearch",
+        "Stackoverflow",
+        "vectorstore"
+    ],
+    "typescript.tsdk": "node_modules/typescript/lib",
+    "markdown.copyFiles.destination": {
+          "**/*": "${documentWorkspaceFolder}/docs/public/images/image.png"
+    }
+}

.vscode/settings.json

@@ -6,7 +6,8 @@
         "onappear",
         "Redisearch",
         "Stackoverflow",
-        "vectorstore"
+        "vectorstore",
+        "chatluna"
     ],
     "typescript.tsdk": "node_modules/typescript/lib",
     "markdown.copyFiles.destination": {

docs/ecosystem/plugin/mcp-client.md

@@ -1,5 +1,7 @@
 # MCP 协议客户端 （MCP Client）
 
+MCP 协议是 Model Context Protocol 的缩写，是 LangChain 提供的一种协议，用于在不同的模型之间传递上下文。
+
 此插件为 ChatLuna 的插件模式提供了 MCP 协议支持。
 
 ## 配置
@@ -17,11 +19,110 @@
 以下是推荐的一些插件源：
 
 - [https://koishi-registry.yumetsuki.moe/index.json](https://koishi-registry.yumetsuki.moe/index.json)
-- [https://kp.itzdrli.cc]([https://kp.itzdrli.cc)
+- [https://kp.itzdrli.cc](https://kp.itzdrli.cc)
 
 :::
 
-> [!NOTE]
-> 文档正在完善中...
+安装后启用插件即可。
+
+## 使用
+
+> [!TIP]
+> 启用此插件时，请确保你当前聊天房间的聊天模式为 `plugin` 插件模式。
+> 可以查看 [聊天模式](../../guide/chat-chain/chat-mode.md) 了解如何切换聊天模式。
+
+你需要在 `chatluna-mcp-client` 插件的配置中设置 `servers` 选项，来指定你想要连接的 MCP 服务器。
+
+启用插件后，按照下图去编辑 JSON 来配置需要连接到的 MCP 服务器：
+
+![alt text](../../public/images/image-85.png)
+
+![alt text](../../public/images/image-86.png)
+
+这里的参数基本和 `Claude Desktop` 和 `Cursor` 的 `mcpServers` 参数一致。
+
+如 `Claude Desktop` 的一个配置如下：
+
+```json
+{
+  "mcpServers": {
+    "exa": {
+      "command": "npx",
+      "args": ["/path/to/exa-mcp-server/build/index.js"],
+      "env": {
+        "EXA_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+转换为下面的格式，编辑到 `chatluna-mcp-client` 插件的 `server` 配置中即可。
+
+```json
+{
+    "exa": {
+      "command": "npx",
+      "args": ["/path/to/exa-mcp-server/build/index.js"],
+      "env": {
+        "EXA_API_KEY": "your-api-key-here"
+      }
+    }
+}
+```
+
+完成后重载插件，如果成功，则会在日志中看到如下信息（会列出可用的工具数目）：
+
+![alt text](../../public/images/image-87.png)
+
+> [!TIP]
+> 请确保你的环境下支持可执行文件的运行。如果不存在，请安装对应的依赖。
+
+## 配置项
+
+此处列举了 `chatluna-mcp-client` 插件的配置项。
+
+### servers
+
+* 类型：`object`
+* 默认值：`{}`
+
+MCP 服务器配置。此配置项用于定义需要连接的 MCP 服务器。每个服务器以键值对的形式配置，键为服务器名称，值为服务器配置对象。
+
+服务器配置对象支持以下字段：
+
+#### command
+
+* 类型：`string`
+* 必填：是
+
+执行的命令。可以是可执行文件的路径或者命令名称。
+
+#### args
+
+* 类型：`string[]`
+* 默认值：`[]`
+
+执行命令的参数列表。
+
+#### env
+
+* 类型：`object`
+* 默认值：`{}`
+
+执行环境变量。用于设置 MCP 服务器运行时所需的环境变量，如 API 密钥等。
+
+#### cwd
+
+* 类型：`string`
+* 默认值：``
+
+执行命令的当前工作目录。
+
+#### url
+
+* 类型：`string`
+* 默认值：``
 
+MCP 服务器的 URL。当使用 HTTP/HTTPS 连接时使用此字段。
 

docs/guide/chat-chain/chat-mode.md

@@ -28,7 +28,10 @@ plugin 模式也是 ChatLuna 主插件中内置的聊天模式。
 
 plugin 模式基于 LangChain 的 `Agent` 和 `Tool`，需要有相关的工具才能让模型调用它们。
 
-但 ChatLuna 主插件中并没有内置可供 plugin 使用的工具，因此你需要安装 [`chatluna-plugin-common`](../../ecosystem/introduction.md) 插件，来为 plugin 模式提供一些工具。
+> [!TIP]
+> ChatLuna 主插件中没有内置可供 plugin 聊天模式使用的工具。
+>
+> 因此你需要安装 [`chatluna-plugin-common`](../../ecosystem/introduction.md) 或 [`chatluna-mcp-client`](../../ecosystem/plugin/mcp-client.md) 插件来为 plugin 模式提供可用的工具。
 
 ### browsing