From 9ffb0f8a4c5f47e4c8be4e4308bf94599499e42a Mon Sep 17 00:00:00 2001
From: Junyan Qin <rockchinq@gmail.com>
Date: Fri, 11 Apr 2025 16:41:37 +0800
Subject: [PATCH] doc: add mcp details

---
 docs/.vitepress/config.mts   |  4 ++++
 docs/workshop/mcp-details.md | 26 ++++++++++++++++++++++++++
 2 files changed, 30 insertions(+)
 create mode 100644 docs/workshop/mcp-details.md

diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
index bcf3e7f8e..afda65de9 100644
--- a/docs/.vitepress/config.mts
+++ b/docs/.vitepress/config.mts
@@ -201,6 +201,10 @@ export default defineConfig({
             text: "如何实现一个消息平台适配器？",
             link: "/workshop/impl-platform-adapter",
           },
+          {
+            text: "在 LangBot 接入完整 MCP 生态",
+            link: "/workshop/mcp-details"
+          }
         ],
       },
       {
diff --git a/docs/workshop/mcp-details.md b/docs/workshop/mcp-details.md
new file mode 100644
index 000000000..ae6f143c7
--- /dev/null
+++ b/docs/workshop/mcp-details.md
@@ -0,0 +1,26 @@
+# MCP 生态详解
+
+[MCP协议](https://modelcontextprotocol.io/) 是一种描述应用程序与 LLM 交互的协议，目前已经被多种产品采用。LangBot 可以作为 MCP Client 接入 MCP Server，大量扩展工具供 LLM 在与用户对话时使用。
+
+## 寻找 MCP Server
+
+要在 LangBot 使用 MCP 工具，需要找到已有的 MCP Server 并接入。  
+市面上有两种类型的 MCP Server：
+
+- 基于 node 或 python 实现的可执行文件，通过 `stdio`（标准输入输出）与 LangBot 通信
+- 基于 http 协议的 web 服务，通过 http 协议与 LangBot 通信
+
+
+:::info
+
+- 可以到 [MCP Server 列表](https://github.com/punkpeye/awesome-mcp-servers) 查看已有的 MCP Server。
+- 在线托管的 MCP Server 可以到 [Composio MCP](https://mcp.composio.dev/) 查找。
+- 自行编写 MCP Server 可以参考 [MCP 协议文档](https://modelcontextprotocol.io/quickstart/server) 和 [MCP Server 示例](https://modelcontextprotocol.io/examples)。
+
+:::
+
+## 配置 MCP Server
+
+查看 [配置文档](/config/function/provider.html#mcp-%E9%85%8D%E7%BD%AE-mcp)
+
+配置完成后即可在聊天中通过`!func`命令查看已经注册的 MCP 工具，在与支持 Function Calling 的模型对话时，LangBot 会自动调用 MCP 工具。
\ No newline at end of file