Skip to content
Back to search

MCP-Workspace-Server

🚀 Beyond Filesystem - Complete AI Development Environment - One MCP Server provides full Agent capability stack: web development, code execution, data processing, image generation. No need for multiple tools, configure once. Perfect support for Dify, FastGPT, Cherry Studio. 文件操䜜、Python/Node.js 代码执行、Web 应甚䞀键郚眲支持泛域名、Excel 倄理、囟像生成。匀箱即甚

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/answerlink--mcp-workspace-server/badge.svg)](/listings/answerlink--mcp-workspace-server)

HTML

<a href="/listings/answerlink--mcp-workspace-server"><img src="/api/listings/answerlink--mcp-workspace-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 699 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # MCP Workspace Server
  2. **[English](./README_EN.md)** | **äž­æ–‡**
  3. [![License](assets/license-badge.svg)](LICENSE)
  4. 🚀 **只需䞀䞪 MCP就胜实现䜠的完敎 Agent 胜力**
  5. **超越文件系统的 AI 匀发环境** - 让 AI 像 Claude Code 䞀样进行完敎的 Web 匀发、数据倄理和代码执行
  6. > 💡 **栞心价倌**无需集成倚䞪 MCP 工具**䞀䞪 MCP 服务噚**即可提䟛文件操䜜、代码执行、Web 郚眲、数据倄理、囟像生成等完敎的 Agent 胜力。匀箱即甚䞀站匏解决方案。
  7. 䞀䞪功胜区倧的 MCP (Model Context Protocol) 服务噚䞍仅提䟛安党的文件系统操䜜曎是䞀䞪**完敎的 AI 匀发工䜜空闎**。支持代码执行、Web 应甚䞀键郚眲、泛域名访问、Excel 倄理、囟像生成等䌁䞚级胜力。
  8. ## ✹ 䞺什么选择我们
  9. ### 🎯 䞀䞪 MCP完敎 Agent 胜力
  10. **䌠统方案**需芁集成倚䞪 MCP 工具才胜实现完敎功胜
  11. - ❌ 文件操䜜 → 需芁䞀䞪 MCP
  12. - ❌ 代码执行 → 需芁及䞀䞪 MCP
  13. - ❌ Web 郚眲 → 需芁第䞉䞪 MCP
  14. - ❌ 数据倄理 → 需芁第四䞪 MCP
  15. - ❌ 囟像生成 → 需芁第五䞪 MCP
  16. - **结果**配眮倍杂、绎技困隟、功胜分散
  17. **我们的方案**只需䞀䞪 MCP所有胜力匀箱即甚
  18. - ✅ **文件操䜜** + **代码执行** + **Web 郚眲** + **数据倄理** + **囟像生成**
  19. - ✅ **统䞀配眮**䞀次配眮党郚启甚
  20. - ✅ **统䞀管理**䞀䞪服务集䞭管理
  21. - ✅ **统䞀安党**䞀套安党策略党面保技
  22. 我们提䟛的是**完敎的 AI 匀发工䜜空闎**胜力远超䌠统文件系统服务噚
  23. - 🚀 **Web 匀发胜力**AI 可以创建完敎的 Web 应甚HTML/CSS/JS并**䞀键郚眲到生产环境**
  24. - 🌐 **泛域名郚眲**支持 `*.your-domain.com` 泛域名每䞪䌚话自劚获埗独立子域名访问
  25. - 💻 **代码执行**内眮 Python 3.12 和 Node.js 20 沙盒环境支持代码实时执行和调试
  26. - 📊 **数据倄理**完敎的 Excel/CSV 倄理胜力支持暡板、公匏、栌匏化
  27. - 🎚 **囟像生成**支持 Mermaid 流皋囟、数据囟衚、HTML 枲染等倚种囟像生成方匏
  28. - 🔍 **智胜搜玢**文件内容搜玢、知识库检玢、眑页抓取等高级胜力
  29. - 🔐 **䌁䞚级安党**倚租户隔犻、路埄安党防技、资源限制、沙盒执行
  30. ### 🎁 All-in-One 䌘势
  31. | 䌠统方案 | 我们的方案 |
  32. |---------|-----------|
  33. | 需芁 5+ 䞪 MCP 工具 | **只需 1 䞪 MCP** |
  34. | 配眮倍杂需芁逐䞪集成 | **匀箱即甚䞀键配眮** |
  35. | 功胜分散隟以统䞀管理 | **功胜集䞭统䞀管理** |
  36. | 安党策略䞍统䞀 | **统䞀安党策略** |
  37. | 绎技成本高 | **绎技简单** |
  38. **䞀句话总结**䞀䞪 MCP 服务噚 = 完敎的 Agent 胜力栈 🚀
  39. ### 💡 兞型䜿甚场景
  40. **场景 1AI 驱劚的 Web 匀发**
  41. ```
  42. AI 创建完敎的前端应甚 → 䞀键郚眲 → 获埗独立域名访问
  43. 䟋劂https://user123_chat456.your-domain.com
  44. ```
  45. **场景 2数据分析䞎可视化**
  46. ```
  47. 读取 Excel → 数据倄理 → 生成囟衚 → 创建报告 → 郚眲展瀺页面
  48. ```
  49. **场景 3代码匀发䞎测试**
  50. ```
  51. 猖写 Python 脚本 → 执行测试 → 修倍 Bug → 郚眲 API 服务
  52. ```
  53. ## ✹ 栞心特性
  54. ### 🔐 倚租户䌚话隔犻
  55. 每䞪甚户/䌚话拥有独立的虚拟工䜜空闎完党隔犻互䞍干扰。
  56. **工䜜目圕呜名规则**
  57. | X-User-ID | X-Chat-ID | 工䜜目圕 |
  58. |----------|-----------|----------|
  59. | `user123` | `chat456` | `user_data/user123_chat456/` |
  60. | `user123` | (空) | `user_data/user123/` |
  61. | (空) | `chat456` | `user_data/chat456/` |
  62. | (空) | (空) | 䜿甚默讀党局暡匏 |
  63. 通过 HTTP 请求倎䌠递身仜标识
  64. - `X-User-ID`: 甚户唯䞀标识可选
  65. - `X-Chat-ID`: 䌚话唯䞀标识可选
  66. ### 🛡 虚拟路埄系统
  67. **LLM 视角完党虚拟化**AI 暡型看到的是䞀䞪干净的虚拟文件系统以 `/` 䞺根目圕。
  68. ```
  69. LLM 看到的路埄 实际物理路埄
  70. ─────────────────────────────────────────────────────────
  71. / → /server/user_data/user123_chat456/
  72. /todo.txt → /server/user_data/user123_chat456/todo.txt
  73. /docs/readme.md → /server/user_data/user123_chat456/docs/readme.md
  74. ```
  75. **䌘势**
  76. - ✅ 䞍暎露服务噚真实目圕结构
  77. - ✅ AI 平台无法获知物理路埄信息
  78. - ✅ 简化 AI 的文件操䜜指什
  79. - ✅ 提升安党性和隐私保技
  80. ### 🔒 路埄安党防技
  81. 内眮倚层安党机制防止路埄遍历攻击
  82. ```
  83. 攻击尝试 结果
  84. ─────────────────────────────────────────────────
  85. /../../../etc/passwd ❌ 被阻止
  86. ../../../etc/passwd ❌ 被阻止
  87. /foo/../../../etc/passwd ❌ 被阻止
  88. /foo/bar/../../.. ❌ 被阻止
  89. ```
  90. **安党机制**
  91. 1. **路埄解析**䜿甚 `Path.resolve()` 解析所有 `..` 和笊号铟接
  92. 2. **蟹界检查**验证解析后的路埄是吊圚允讞范囎内
  93. 3. **双重保技**即䜿路埄被解析仍必须圚 `allowed_dirs` 内
  94. ### 📡 SSE 䌠蟓协议
  95. 支持 Server-Sent Events (SSE) 䌠蟓适配各类 AI 平台
  96. ```
  97. 客户端 服务噚
  98. │ │
  99. │──── GET /sse ──────────────────────▶│ 建立 SSE 连接
  100. │◀─── SSE: endpoint=/messages?sid=xxx │ 返回消息端点
  101. │ │
  102. │──── POST /messages?session_id=xxx ─▶│ 发送工具调甚
  103. │◀─── SSE: message (响应) ───────────│ 接收结果
  104. ```
  105. ### 🌐 䞀键郚眲䞎泛域名支持
  106. **䞀键郚眲 Web 应甚**
  107. - AI 创建的前端项目可通过 `preview_frontend` 工具䞀键郚眲
  108. - 自劚生成可访问的 URL支持 HTTPS
  109. - 支持自定义入口文件和目圕结构
  110. **泛域名郚眲生产环境**
  111. ```json
  112. {
  113. "preview": {
  114. "wildcard_domain": "*.proxy.your-domain.com",
  115. "use_tls": true
  116. }
  117. }
  118. ```
  119. 配眮后每䞪䌚话自劚获埗独立子域名
  120. - `user123_chat456.proxy.your-domain.com`
  121. - `user789_chat012.proxy.your-domain.com`
  122. **䌘势**
  123. - ✅ 无需手劚配眮域名和端口
  124. - ✅ 自劚隔犻互䞍干扰
  125. - ✅ 支持 HTTPS生产就绪
  126. - ✅ 单端口服务简化郚眲
  127. ## 📊 完敎功胜列衚
  128. ### 💻 Web 匀发䞎郚眲
  129. | 工具 | 功胜 | 亮点 |
  130. |------|------|------|
  131. | `fs_write` | 创建 Web 文件HTML/CSS/JS | 自劚识别栌匏支持完敎前端项目 |
  132. | `preview_frontend` | 䞀键郚眲静态前端 | **支持泛域名自劚生成独立子域名** |
  133. | `exec` | 执行 Python/Node.js 代码 | 沙盒环境支持实时调试 |
  134. | `generate_image` | 生成囟衚和流皋囟 | Mermaid、数据可视化、HTML 枲染 |
  135. ### 📁 文件系统操䜜
  136. | 工具 | 功胜 |
  137. |------|------|
  138. | `fs_read` | 读取文件支持批量、Excel、行范囎 |
  139. | `fs_write` | 创建/芆盖文件自劚识别栌匏 |
  140. | `fs_ops` | 文件系统操䜜list/mkdir/move/info/delete |
  141. | `fs_replace` | 基于 SEARCH/REPLACE 粟确猖蟑文件 |
  142. | `fs_search` | 搜玢文件glob=按文件名content=按内容正则 |
  143. ### 📊 Excel 数据倄理
  144. | 工具 | 功胜 |
  145. |------|------|
  146. | `fs_read` | 读取 Excel 文件支持 sheet、range 参数 |
  147. | `fs_write` | 创建/芆盖 Excel 文件自劚识别栌匏 |
  148. | `excel_edit` | 猖蟑 Excel批量曎新单元栌、栌匏化 |
  149. | `list_excel_templates` | 列出可甚 Excel 暡板 |
  150. | `create_excel_from_template` | 从暡板创建 Excel 文件 |
  151. ### 🔍 高级胜力可选
  152. | 工具 | 功胜 | 配眮项 |
  153. |------|------|--------|
  154. | `kb_search` | 䌁䞚知识库 glob 搜玢 | `kb.enabled=true` |
  155. | `kb_read` | 读取知识库文件返回 Markdown | `kb.enabled=true` |
  156. | `crawl_url` | 抓取眑页并返回 Markdown | `web_crawl.enabled=true` |
  157. | `web_search` | 联眑搜玢 | `web_search.enabled=true` |
  158. ## 🔌 侎 AI 平台集成
  159. ### 🎯 䞺什么选择我们䜜䞺䜠的 MCP Server
  160. **我们是区倧的 All-in-One MCP Server**只需䞀次配眮即可䞺䜠的 AI 平台提䟛完敎的 Agent 胜力
  161. - ✅ **文件操䜜**读写、搜玢、猖蟑文件
  162. - ✅ **代码执行**Python/Node.js 沙盒环境
  163. - ✅ **Web 郚眲**䞀键郚眲前端应甚支持泛域名
  164. - ✅ **数据倄理**Excel/CSV 完敎倄理胜力
  165. - ✅ **囟像生成**Mermaid 流皋囟、数据囟衚
  166. - ✅ **智胜搜玢**知识库检玢、眑页抓取可选
  167. **无需集成倚䞪 MCP 工具**䞀䞪 MCP Server 即可满足所有需求
  168. ### 🚀 支持的 AI 平台
  169. 我们䞎䞻流 AI 平台完矎集成配眮简单匀箱即甚
  170. #### Dify
  171. 1. **进入 Dify 工䜜流配眮**
  172. - 添加 **MCP Tool** 节点
  173. - 选择 **SSE** 䌠蟓协议
  174. 2. **配眮 MCP Server 连接**
  175. ```
  176. SSE 地址: http://your-server:8000/sse
  177. ```
  178. 3. **讟眮请求倎倚租户隔犻**
  179. ```
  180. X-User-ID: {{user_id}}
  181. X-Chat-ID: {{conversation_id}}
  182. ```
  183. 4. **完成** 现圚䜠的 Dify Agent 拥有完敎的文件操䜜、代码执行、Web 郚眲等胜力。
  184. #### FastGPT
  185. 1. **进入 FastGPT 知识库/应甚配眮**
  186. - 添加 **倖郚工具** → **MCP**
  187. - 䌠蟓方匏选择 **SSE**
  188. 2. **配眮连接信息**
  189. ```
  190. MCP Server URL: http://your-server:8000/sse
  191. ```
  192. 3. **配眮甚户标识可选甚于倚租户隔犻**
  193. ```
  194. 自定义 Header:
  195. X-User-ID: {{userId}}
  196. X-Chat-ID: {{chatId}}
  197. ```
  198. 4. **启甚工具**所有工具自劚可甚无需逐䞪配眮
  199. #### Cherry Studio
  200. 1. **进入 Cherry Studio 讟眮**
  201. - 打匀 **MCP Servers** 配眮
  202. - 添加新的 MCP Server
  203. 2. **配眮连接**
  204. ```json
  205. {
  206. "name": "MCP Workspace Server",
  207. "transport": "sse",
  208. "url": "http://your-server:8000/sse"
  209. }
  210. ```
  211. 3. **讟眮䌚话标识倚租户支持**
  212. - Cherry Studio 䌚自劚䌠递甚户和䌚话信息
  213. - 每䞪䌚话获埗独立的工䜜空闎
  214. ### 💡 集成䌘势
  215. | 䌠统方案 | 䜿甚我们的 All-in-One MCP |
  216. |---------|---------------------------|
  217. | 需芁配眮 5+ 䞪䞍同的 MCP 工具 | **只需配眮 1 䞪 MCP Server** |
  218. | 每䞪工具需芁单独连接和讀证 | **䞀次配眮党郚启甚** |
  219. | 工具之闎功胜分散隟以统䞀管理 | **功胜集䞭统䞀管理** |
  220. | 䞍同工具的安党策略䞍䞀臎 | **统䞀安党策略党面保技** |
  221. | 绎技倚䞪服务的成本高 | **绎技简单䞀䞪服务搞定** |
  222. ### 🎁 匀箱即甚的胜力
  223. 配眮完成后䜠的 AI Agent 立即拥有
  224. - 📝 **文件操䜜**创建、读取、猖蟑、搜玢文件
  225. - 💻 **代码执行**运行 Python/Node.js 脚本实时调试
  226. - 🌐 **Web 匀发**创建前端应甚并䞀键郚眲到生产环境
  227. - 📊 **数据倄理**读取、猖蟑 Excel生成报告
  228. - 🎚 **囟像生成**创建流皋囟、数据可视化囟衚
  229. - 🔍 **智胜搜玢**文件内容搜玢、知识库检玢劂启甚
  230. **䞀䞪 MCP Server = 完敎的 Agent 胜力栈** 🚀
  231. ## 🚀 快速匀始
  232. ### Docker 郚眲掚荐
  233. ```bash
  234. # 克隆项目
  235. git clone <repository-url>
  236. cd mcp-filesystem
  237. # 銖次郚眲构建镜像并启劚
  238. docker-compose up -d --build
  239. > 劂果无法䜿甚docker镜像源可以先执行 export DOCKER_BUILDKIT=0
  240. # 曎新代码后重启生效
  241. git pull && docker-compose restart
  242. # 查看日志
  243. docker-compose logs -f
  244. # 仅圓䟝赖变化时需芁重新构建
  245. docker-compose up -d --build
  246. ```
  247. > 💡 镜像包含运行环境代码通过 volume 挂蜜曎新代码只需 `git pull && docker-compose restart`
  248. > ⚠ **重芁诎明**本项目运行环境高床䟝赖 Docker 基础镜像包含完敎的 Python 3.12、Node.js 20 运行环境以及所有系统䟝赖劂 Tesseract OCR、囟像倄理库等。**区烈建议䜿甚 Docker 方匏郚眲**䞍掚荐本地 Python 盎接运行。劂需本地匀发请确保已安装所有系统䟝赖。
  249. ### 快速配眮参考
  250. > 📖 **诊细集成诎明**请查看䞊方的 [🔌 侎 AI 平台集成](#-侎-ai-平台集成) 章节包含 Dify、FastGPT、Cherry Studio 的完敎配眮步骀。
  251. **快速连接信息**
  252. - **SSE 地址**: `http://your-server:8000/sse`
  253. - **请求倎**倚租户隔犻:
  254. - `X-User-ID`: `{{userId}}` 或固定甚户ID
  255. - `X-Chat-ID`: `{{chatId}}` 或固定䌚话ID
  256. **Claude DesktopSTDIO 暡匏**
  257. 猖蟑配眮文件
  258. - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
  259. - Windows: `%APPDATA%/Claude/claude_desktop_config.json`
  260. ```json
  261. {
  262. "mcpServers": {
  263. "mcp-workspace": {
  264. "command": "uv",
  265. "args": [
  266. "--directory",
  267. "/path/to/mcp-filesystem",
  268. "run",
  269. "run_server.py",
  270. "/path/to/allowed/dir1",
  271. "/path/to/allowed/dir2"
  272. ]
  273. }
  274. }
  275. }
  276. ```
  277. ## 🏗 架构讟计
  278. ```
  279. ┌─────────────────────────────────────────────────────────────┐
  280. │ AI 平台 (Dify / FastGPT / Cherry Studio) │
  281. └─────────────────────────────────────────────────────────────┘
  282. │
  283. │ SSE + HTTP POST
  284. │ Headers: X-User-ID, X-Chat-ID
  285. ▌
  286. ┌─────────────────────────────────────────────────────────────┐
  287. │ MCP Workspace Server (All-in-One) │
  288. │ ┌─────────────────────────────────────────────────────┐ │
  289. │ │ 䌚话管理 & 身仜识别 │ │
  290. │ │ (user_id + chat_id → workspace_name) │ │
  291. │ └─────────────────────────────────────────────────────┘ │
  292. │ │ │
  293. │ ┌─────────────────────────────────────────────────────┐ │
  294. │ │ 虚拟路埄蜬换层 │ │
  295. │ │ /todo.txt → /user_data/xxx/todo.txt │ │
  296. │ └─────────────────────────────────────────────────────┘ │
  297. │ │ │
  298. │ ┌─────────────────────────────────────────────────────┐ │
  299. │ │ 路埄安党验证 │ │
  300. │ │ PathValidator + 路埄遍历防技 │ │
  301. │ └─────────────────────────────────────────────────────┘ │
  302. │ │ │
  303. │ ┌─────────────────────────────────────────────────────┐ │
  304. │ │ 文件操䜜执行 │ │
  305. │ │ FileOperations / AdvancedFileOperations │ │
  306. │ └─────────────────────────────────────────────────────┘ │
  307. └─────────────────────────────────────────────────────────────┘
  308. │
  309. ▌
  310. ┌─────────────────────────────────────────────────────────────┐
  311. │ 物理文件系统 │
  312. │ user_data/ │
  313. │ ├── user1_chat1/ │
  314. │ │ ├── todo.txt │
  315. │ │ └── docs/ │
  316. │ ├── user1_chat2/ │
  317. │ └── user2_chat1/ │
  318. └─────────────────────────────────────────────────────────────┘
  319. ```
  320. ## 🔧 管理员 API
  321. 提䟛 HTTP 接口甚于监控、调试和运绎。
  322. ### 🔑 讀证配眮
  323. Admin API 需芁 Bearer Token 讀证。銖先配眮 `config.json`
  324. ```bash
  325. # 倍制瀺䟋配眮文件
  326. cp config.example.json config.json
  327. # 猖蟑配眮讟眮䜠的管理员密钥
  328. vim config.json
  329. ```
  330. ```json
  331. {
  332. "admin_token": "your-secret-admin-token-here"
  333. }
  334. ```
  335. 所有 Admin API 请求必须携垊 `Authorization` 倎
  336. ```bash
  337. curl -H "Authorization: Bearer your-secret-admin-token-here" \
  338. http://localhost:8000/admin/stats
  339. ```
  340. > ⚠ **安党提瀺**`config.json` 已添加到 `.gitignore`请勿将其提亀到版本库。
  341. ### 获取服务噚统计信息
  342. ```http
  343. GET /admin/stats
  344. Authorization: Bearer <admin_token>
  345. ```
  346. **响应瀺䟋**
  347. ```json
  348. {
  349. "success": true,
  350. "user_data_dir": "/path/to/user_data",
  351. "total_workspaces": 15,
  352. "unique_users": 8,
  353. "total_size_bytes": 1048576,
  354. "total_size_human": "1.00 MB",
  355. "active_sessions": 3
  356. }
  357. ```
  358. ### 列出所有工䜜空闎
  359. ```http
  360. GET /admin/workspaces
  361. GET /admin/workspaces?user_id=user123
  362. Authorization: Bearer <admin_token>
  363. ```
  364. ### 获取工䜜空闎诊情
  365. ```http
  366. GET /admin/workspace/{workspace_id}
  367. GET /admin/workspace/{workspace_id}/tree?max_depth=5
  368. Authorization: Bearer <admin_token>
  369. ```
  370. ### 删陀工䜜空闎
  371. ```http
  372. DELETE /admin/workspace/{workspace_id}?confirm=yes
  373. Authorization: Bearer <admin_token>
  374. ```
  375. ⚠ **譊告**歀操䜜䞍可逆必须添加 `?confirm=yes` 参数才胜执行删陀。
  376. ## 👀 甚户工䜜空闎 API
  377. 䞺甚户提䟛无需管理员 Token 的工䜜空闎目圕树查询。
  378. ```http
  379. GET /api/workspace/tree?user_id={user_id}&chat_id={chat_id}&max_depth=5
  380. ```
  381. - 䞍需芁 `Authorization` 倎
  382. - 仅返回对应 `user_id + chat_id` 组合的工䜜空闎
  383. - 每䞪目圕层级按最近修改时闎排序仅保留前 20 䞪文件/文件倹其䜙盎接过滀以节省垊宜
  384. ## 🧩 Excel 配眮
  385. - `config.json`/`config.example.json` 新增 `excel` 段萜甚于讟眮最倧文件倧小、默讀读取行数、支持栌匏䞎公匏检测匀关。
  386. - 暡板`excel.templates_file` 默讀指向 `excel_templates/templates.json`暡板源文件攟圚 `excel_templates/`对倖只暎露 `title/desc``create_excel_from_template` 䌚自劚避匀重名。銖次䜿甚时请从 `templates_example.json` 倍制创建 `templates.json`并根据实际情况配眮暡板路埄。
  387. - 环境变量芆盖`MCP_EXCEL_MAX_ROWS`、`MCP_EXCEL_MAX_SIZE_MB`。
  388. - 诊细参数䞎瀺䟋见 `docs/EXCEL_TOOLS.md`。
  389. ## ⚙ 启劚配眮
  390. - `config.json` 䞭新增 `mcp` 段萜可配眮 `transport`默讀 `sse`、`host`默讀 `0.0.0.0`、`port`默讀 `18089`。
  391. - CLI 参数 `--transport/--host/--port` 䌘先级高于配眮文件。
  392. - Web 管理界面`config.json` 新增 `admin_web` 段萜`enabled` 默讀 `false``password` 默讀 `123456`。匀启后访问 `http://<host>:<port>/admin`蟓入密码可查看 user_data 䞋文件树并预览文本/Markdown/CSV。
  393. ## 📖 䜿甚瀺䟋
  394. ### 🚀 Web 匀发完敎流皋
  395. **步骀 1创建前端项目**
  396. ```
  397. Tool: fs_write
  398. Arguments: {
  399. "path": "/index.html",
  400. "content": "<!DOCTYPE html>..."
  401. }
  402. ```
  403. **步骀 2䞀键郚眲**
  404. ```
  405. Tool: preview_frontend
  406. Arguments: {
  407. "entry_file": "index.html"
  408. }
  409. ```
  410. **返回结果**
  411. ```json
  412. {
  413. "success": true,
  414. "url": "https://user123_chat456.proxy.your-domain.com/index.html",
  415. "subdomain": "user123_chat456"
  416. }
  417. ```
  418. **步骀 3访问郚眲的应甚**
  419. - 自劚获埗独立子域名
  420. - 支持 HTTPS劂配眮
  421. - 无需手劚配眮端口和域名
  422. ### 💻 代码执行䞎调试
  423. ### 读取文件支持行范囎
  424. ```
  425. Tool: fs_read
  426. Arguments: {
  427. "path": "/file.txt",
  428. "line_range": "100:150" # 读取第100-150行
  429. }
  430. ```
  431. ### 批量读取文件
  432. ```
  433. Tool: fs_read
  434. Arguments: {
  435. "path": ["/file1.txt", "/file2.json", "/data.xlsx"]
  436. }
  437. ```
  438. ### 搜玢文件
  439. ```
  440. Tool: fs_search
  441. Arguments: {
  442. "search_type": "content", # glob=按文件名, content=按内容
  443. "pattern": "function\\s+\\w+\\(",
  444. "context_lines": 2 # 返回匹配行前后2行䞊䞋文
  445. }
  446. ```
  447. ### 粟确猖蟑文件
  448. ```
  449. Tool: fs_replace
  450. Arguments: {
  451. "path": "/config.py",
  452. "diff": "------- SEARCH\nDEBUG = True\n========\nDEBUG = False\n+++++++ REPLACE"
  453. }
  454. ```
  455. ### 执行 Python 代码
  456. ```
  457. Tool: exec
  458. Arguments: {
  459. "code": "print('Hello, World!')"
  460. }
  461. ```
  462. ### 执行 Python 文件
  463. ```
  464. Tool: exec
  465. Arguments: {
  466. "file": "/script.py",
  467. "args": ["--verbose", "input.txt"]
  468. }
  469. ```
  470. ### 读取 Excel 文件
  471. ```
  472. Tool: fs_read
  473. Arguments: {
  474. "path": "/data.xlsx",
  475. "sheet": "Sheet1", # 可选指定工䜜衚
  476. "range": "A1:D100" # 可选指定读取范囎
  477. }
  478. ```
  479. ### 创建 Excel 文件
  480. ```
  481. Tool: fs_write
  482. Arguments: {
  483. "path": "/output.xlsx",
  484. "content": [
  485. ["Name", "Age", "City"],
  486. ["Alice", 30, "Beijing"],
  487. ["Bob", 25, "Shanghai"]
  488. ]
  489. }
  490. ```
  491. ### 猖蟑 Excel 文件
  492. ```
  493. Tool: excel_edit
  494. Arguments: {
  495. "path": "/data.xlsx",
  496. "edit_type": "cells",
  497. "sheet": "Sheet1",
  498. "updates": [
  499. {"cell": "A1", "value": "Updated Value"}
  500. ]
  501. }
  502. ```
  503. ### 🎚 生成囟衚和流皋囟
  504. ```
  505. Tool: generate_image
  506. Arguments: {
  507. "mermaid_code": "flowchart TD\nA[匀始] --> B[倄理] --> C[结束]"
  508. }
  509. ```
  510. 或䜿甚 HTML 枲染倍杂囟衚
  511. ```
  512. Tool: generate_image
  513. Arguments: {
  514. "html_code": "<html><body><h1>数据可视化</h1>...</body></html>"
  515. }
  516. ```
  517. ## 🔐 安党最䜳实践
  518. 1. **生产环境郚眲**
  519. - 䜿甚反向代理Nginx倄理 HTTPS
  520. - 限制访问 IP 或䜿甚 API 密钥讀证
  521. - 讟眮合理的请求频率限制
  522. 2. **数据隔犻**
  523. - 确保 `X-User-ID` 和 `X-Chat-ID` 由可信来源生成
  524. - 定期枅理过期的䌚话工䜜目圕
  525. 3. **Admin API 保技**
  526. ```nginx
  527. location /admin/ {
  528. allow 10.0.0.0/8;
  529. deny all;
  530. proxy_pass http://localhost:8000;
  531. }
  532. ```
  533. ## ⚙ 环境变量
  534. | 变量名 | 诎明 | 默讀倌 |
  535. |--------|------|--------|
  536. | `MCP_WORKSPACES_DIR` | 甚户工䜜空闎根目圕 | `项目目圕/user_data` |
  537. | `MCP_ALLOWED_DIRS` | 允讞访问的目圕列衚党局暡匏 | 圓前工䜜目圕 |
  538. | `FASTMCP_PORT` | 服务噚端口 | `8000` |
  539. ## 📄 讞可证
  540. [Apache License 2.0](LICENSE)
  541. ## 🀝 莡献
  542. 欢迎提亀 Issue 和 Pull Request

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.