NetSuite MCP Server

一个通过OAuth 2.0和PKCE认证提供对NetSuite数据访问的模型上下文协议（MCP）服务器。无缝地与任何兼容MCP的客户端一起工作，包括Claude Code、Cursor IDE和Gemini CLI。

动机和背景

NetSuite提供了一个官方的AI连接器SuiteApp，使用户能够通过AI与NetSuite数据进行交互。然而，NetSuite的AI连接器目前仅支持：

• 通过Anthropic的Web界面与Claude连接
• 通过自定义的GPT连接与ChatGPT连接

问题在于：使用兼容MCP工具（如Claude Code、Cursor IDE、Windsurf或其他CLI/IDE环境）的开发者无法利用NetSuite的AI能力，因为没有实现MCP服务器。

这个MCP服务器解决了这一缺口：

• 提供了MCP客户端（如Claude Code、Cursor、Gemini CLI等）与NetSuite AI连接器之间的缺失桥梁。
• 实现了与NetSuite AI连接器相同的全部功能，但可以通过任何兼容MCP的客户端访问。
• 允许开发者在他们的开发环境中直接使用自然语言与NetSuite数据进行交互。
• 维持与NetSuite官方AI连接器相同的相同安全标准（OAuth 2.0与PKCE）。

简而言之，这个MCP服务器将NetSuite的AI能力带入更广泛的MCP生态系统中，允许开发者查询业务数据、生成报告并自动化NetSuite操作，而无需离开他们的IDE或CLI。

特性

• ✅ OAuth 2.0与PKCE - 不需要客户端密钥的安全认证
• ✅ 自动令牌刷新 - 在令牌过期前自动刷新
• ✅ 环境变量支持 - 在你的MCP配置中一次性配置凭证
• ✅ 会话持久化 - 认证信息在服务器重启后仍然有效
• ✅ 通用MCP集成 - 与Claude Code、Cursor IDE、Gemini CLI和其他MCP客户端兼容
• ✅ NetSuite MCP工具 - 访问所有NetSuite MCP功能（SuiteQL、报表、保存搜索等）
• ✅ 模块化架构 - 遵循单一职责原则的干净可维护代码库

快速开始

1. NetSuite设置

第一步：安装NetSuite AI连接器SuiteApp

在创建集成记录之前，必须安装并配置NetSuite AI连接器SuiteApp：

重要提示：NetSuite AI连接器SuiteApp是MCP功能所必需的。如果没有安装，即使经过认证，MCP工具也不会可用。

第二步：创建OAuth集成记录

安装SuiteApp后，创建一个集成记录：

1. 导航到 设置 > 集成 > 管理集成 > 新建
2. 填写详情：
   • 名称："MCP Server Integration"
   • OAuth 2.0：选中授权码授权 选中公共客户端
   • 重定向URI：http://localhost:8080/callback（或自定义端口）
3. 保存并复制客户端ID（消费者密钥）

注意：我们不需要客户端密钥（因为这是一个公共客户端，并且使用授权码授权与PKCE）。

2. MCP客户端配置

添加到你的MCP客户端配置文件中：

Claude Code：~/.claude.json Cursor IDE：.cursor/mcp.json Gemini CLI：根据Gemini的MCP设置

方案A：使用npx（推荐 - 无需安装）

{
  "mcpServers": {
    "netsuite": {
      "command": "npx",
      "args": ["@suiteinsider/netsuite-mcp@latest"],
      "env": {
        "NETSUITE_ACCOUNT_ID": "your-account-id",
        "NETSUITE_CLIENT_ID": "your-client-id",
        "OAUTH_CALLBACK_PORT": "8080"
      }
    }
  }
}

优点：

• 无需手动安装
• 使用最新版本@latest
• 清晰简单的配置
• 在MCP客户端重启后立即生效

可选环境变量：

• OAUTH_CALLBACK_PORT - OAuth回调端口（默认：8080）

方案B：本地开发设置

用于贡献或本地开发：

# 克隆仓库
git clone https://github.com/dsvantien/netsuite-mcp-server.git
cd netsuite-mc