NetSuite MCP 网页助理

一个基于NetSuite MCP和DeepSeek的网页聊天工具,支持工具调用和API转发。

  • by Bolton-Z
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 letian940-prog/netsuite-mcp-assistant

使用说明

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/list
  • POST {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)

  1. 把整个 netsuite-mcp-assistant 文件夹上传到 GitHub 仓库
  2. 打开 Vercel,新建项目,导入该仓库
  3. 在 Vercel 的环境变量里配置(可选,但推荐):
    • DEESEEK_API_KEY
    • DEESEEK_API_BASE(可选)
  4. 点击 Deploy

4) 常见问题

Q1:我填了 MCP Base URL 但工具列表加载失败?

  • 你需要确认你的 MCP 服务是否支持本项目默认的两个路径:
    • POST /tools/list
    • POST /tools/call
  • 如果不同,请修改:
    • src/app/api/mcp/tools/route.ts
    • src/app/api/mcp/call/route.ts

Q2:DeepSeek 报 401/403?

  • DeepSeek key 不对,或你的账号没权限。重新检查 key。