geoc-space-visual-api MCP

这是 geoc-space-visual 项目的 MCP 服务，工具定义从 docs/apifox/geoc-space-visual.openapi.json 生成。

工具

当前版本暴露 22 个工具，覆盖当前 NestJS 控制器中的非删除接口：

• work_*：文件夹、工程、工作资源查询和更新
• dashboard_*：仪表盘创建、查询、更新、复制和公开状态切换
• cats_*：脚手架示例接口

显式删除接口 POST /dashboard/delete 未写入 OpenAPI 文档，因此不会生成 MCP tool。POST /dashboard/batch 保留批量启用、禁用、公开和私有化能力，但不暴露 delete 操作。

环境变量

• GSV_API_BASE_URL：接口基础地址，默认 http://localhost:6008/gsv/api/v1
• GSV_API_TOKEN：接口鉴权 token，可直接写 token，服务会自动补 Bearer
• GSV_API_AUTHORIZATION：完整 Authorization 值；当已包含 Bearer 时会原样使用

不要把真实 token 写入仓库、README、测试或 MCP 配置模板。

本地运行

npm install
npm run generate:tools
npm run build
GSV_API_BASE_URL=http://localhost:6008/gsv/api/v1 npm start

真实接口调用通常需要在 MCP 客户端配置中设置 GSV_API_TOKEN。

Apifox

Apifox 可直接导入：

docs/apifox/geoc-space-visual.openapi.json

更新接口文档后，重新运行：

npm run generate:tools
npm test
npm run build

Codex MCP 配置

本地开发时可以用绝对路径启动：

[mcp_servers.geoc-space-visual-api]
command = "node"
args = ["/Users/yinyoudexing/Desktop/桌面/project/产品/geoc-space-visual/mcp/geoc-space-visual-api/dist/server.js"]

[mcp_servers.geoc-space-visual-api.env]
GSV_API_BASE_URL = "http://localhost:6008/gsv/api/v1"
GSV_API_TOKEN = "your-token"

发布成 npm 包后，建议改为 npx 固定版本启动。