使用说明
NetSuite MCP + DeepSeek 网页助理(可直接运行)
这是一个“类似 Cherry Studio 的连接器”最小可用版本:
- 网页配置:MCP Base URL / MCP Token / DeepSeek Key(默认仅保存在浏览器本地 localStorage)
- 网页聊天:把你的问题发给 DeepSeek;可选把 NetSuite MCP 的工具列表注入上下文,并提供一个“工具调用”按钮(演示用)
- 后端转发:由 Next.js API Route 统一转发 DeepSeek 与 MCP 请求,避免浏览器跨域
说明:不同 NetSuite MCP 服务实现的 HTTP 路由可能不同。本项目默认使用一种常见的“HTTP 转发形态”:
POST {MCP_BASE_URL}/tools/listPOST {MCP_BASE_URL}/tools/call
若你的服务端不是这个路径,你只要改src/app/api/mcp/*两个路由里的转发路径即可。
0) 先安装 Node.js(你现在机器里没有)
最推荐(最简单)
- 打开 Node.js 官网下载 LTS 安装包并安装:
https://nodejs.org/ - 安装完成后,重启一个终端,执行:
node -v
npm -v
能看到版本号就成功了。
1) 本地运行(按顺序复制粘贴)
进入项目目录:
cd /Users/bolton/自己创建MCP/netsuite-mcp-assistant
安装依赖:
npm install
启动:
npm run dev
浏览器打开:http://localhost:3000
2) 配置方式(两种任选一种)
A. 直接在网页里填(推荐新手)
- MCP Base URL(你的 NetSuite MCP 服务地址)
- MCP Token(如果有)
- DeepSeek API Key(你的 DeepSeek key)
这些会保存在你的浏览器 localStorage。
B. 用环境变量(更安全)
复制 env.example 为 .env.local,然后填:
cp env.example .env.local
然后编辑 .env.local:
DEESEEK_API_KEY=...DEESEEK_API_BASE=...(可不填)
MCP 的 Base URL / Token 仍然建议你用网页配置(因为每个用户可能不同)。
3) 部署(最省心:Vercel)
- 把整个
netsuite-mcp-assistant文件夹上传到 GitHub 仓库 - 打开 Vercel,新建项目,导入该仓库
- 在 Vercel 的环境变量里配置(可选,但推荐):
DEESEEK_API_KEYDEESEEK_API_BASE(可选)
- 点击 Deploy
4) 常见问题
Q1:我填了 MCP Base URL 但工具列表加载失败?
- 你需要确认你的 MCP 服务是否支持本项目默认的两个路径:
POST /tools/listPOST /tools/call
- 如果不同,请修改:
src/app/api/mcp/tools/route.tssrc/app/api/mcp/call/route.ts
Q2:DeepSeek 报 401/403?
- DeepSeek key 不对,或你的账号没权限。重新检查 key。