MCP服务器功能

SaaSus API MCP Server作为Model Context Protocol (MCP)服务器,使SaaSus Platform API能够通过Claude Desktop和Cursor等MCP兼容客户端使用。

  • by saasus-platform
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 saasus-platform/saasus-api-mcp-server

使用说明

SaaSus API MCP服务器

SaaSus API MCP Server作为Model Context Protocol(MCP)服务器运行,使SaaSus Platform API可以从Claude Desktop或Cursor等MCP兼容客户机中使用。

前提条件

  • Node.js(v16以上必须、v20以上推奨)
  • npm(包含在Node中)

安装

1.克隆存储库

请使用以下命令克隆项目:。

git clone https://github.com/saasus-platform/saasus-api-mcp-server.git
cd saasus-api-mcp-server

2.安装相关性

请在项目的根目录中执行以下命令。

npm install

确认可用工具

要查看生成工具的说明和参数,请执行以下命令:。

node index.js tools

実行例:

Available Tools:
Workspace: saasus-auth-api-schema
  Collection: get-basic-configurations.js
    get_basic_configurations
      Description: Get basic configurations including domain name and CNAME records.
      Parameters:
    [...]

只读模式下的工具确认

在安全的只读模式下检查工具:

SAASUS_PLATFORM_API_READ_ONLY_MODE=true node index.js tools

実行例:

Available Tools:
(GETメソッドのみのツールが表示されます)

在Claude Desktop中设置

1.确认路径

请检查节点路径。

which node

mcpServer.js查看项目中可用的所有族。

realpath mcpServer.js

2.设置Claude Desktop

打开Claude Desktop,从“设置”→“开发者”→“编辑配置”中添加服务器设置。

{
    "mcpServers": {
        "saasusapis": {
            "command": "/path/to/node",
            "args": [
                "/path/to/mcpServer.js"
            ],
            "env": {
                "SAASUS_PLATFORM_SAASID": "3bCJatwxxx4xxxx",
                "SAASUS_PLATFORM_APIKEY": "wRita7kxxx9N6cqUwxxxx",
                "SAASUS_PLATFORM_SECRETKEY": "BLIxxxrgvTQnSxxxx",
                "SAASUS_PLATFORM_API_URL_BASE": "https://api.saasus.io"
            }
        }
    }
}

设置后,请重新启动Claude Desktop。

3.在只读模式下设置(推荐)

如果您希望安全,请启用只读模式:

{
    "mcpServers": {
        "saasusapis": {
            "command": "/path/to/node",
            "args": [
                "/path/to/mcpServer.js"
            ],
            "env": {
                "SAASUS_PLATFORM_SAASID": "3bCJatwxxx4xxxx",
                "SAASUS_PLATFORM_APIKEY": "wRita7kxxx9N6cqUwxxxx",
                "SAASUS_PLATFORM_SECRETKEY": "BLIxxxrgvTQnSxxxx",
                "SAASUS_PLATFORM_API_URL_BASE": "https://api.saasus.io",
                "SAASUS_PLATFORM_API_READ_ONLY_MODE": "true"
            }
        }
    }
}

只读模式的特点:

  • 安全性:仅可使用GET方法(防止数据变更操作)
  • 用途:最适合数据分析、监视和报告生成
  • 安全性:减少攻击面,防止误操作

在Cursor中设置

1.设置画面的显示

打开Cursor设置并转到“MCP”部分。

2.添加服务器设置(建议使用只读模式)

建议在安全的只读模式下设置:

{
    "mcpServers": {
        "saasusapis": {
            "command": "/path/to/node",
            "args": [
                "/path/to/mcpServer.js"
            ],
            "env": {
                "SAASUS_PLATFORM_SAASID": "3bCJatwxxx4xxxx",
                "SAASUS_PLATFORM_APIKEY": "wRita7kxxx9N6cqUwxxxx",
                "SAASUS_PLATFORM_SECRETKEY": "BLIxxxrgvTQnSxxxx",
                "SAASUS_PLATFORM_API_URL_BASE": "https://api.saasus.io",
                "SAASUS_PLATFORM_API_READ_ONLY_MODE": "true"
            }
        }
    }
}

仅当需要完全访问模式时SAASUS_PLATFORM_API_READ_ONLY_MODE 中所述修改相应参数的值。

获取API凭据

请从SaaSus Platform获取以下凭据:。

  • SAASUS_PLATFORM_APIKEY -API密钥
  • SAASUS_PLATFORM_SAASID -SaaS ID
  • SAASUS_PLATFORM_SECRETKEY -密码键

您可以从SaaSus Platform的SaaS开发控制台>首选项>API密钥获取这些信息。

配置环境变量选项

必须设定

  • SAASUS_PLATFORM_APIKEY -API密钥
  • SAASUS_PLATFORM_SAASID -SaaS ID
  • SAASUS_PLATFORM_SECRETKEY -密码键

选项设置

  • SAASUS_PLATFORM_API_URL_BASE -API基本URL(默认值:https://api.saasus.io)
  • SAASUS_PLATFORM_API_READ_ONLY_MODE -只读模式("true"的有效性,为提高安全性而推荐)

安全建议

使用只读模式

对于生产和安全至关重要的环境,强烈建议使用只读模式:

# 読み取り専用モードでのサーバー起動
SAASUS_PLATFORM_API_READ_ONLY_MODE=true node mcpServer.js

只读模式的优点

  • 防止数据的误变更、删除
  • 降低安全风险
  • 最适合审计和分析用途
  • 在学习、验证环境中的安全利用

适用场面

  • 数据分析报表生成
  • 系统监视和健康检查
  • 培训环境
  • 验证测试环境