@raiseinfo/smartorder-stdio-mcp

智单通文件上传 MCP Server (stdio 模式)

功能特性

• upload_local_file: 读取本地文件并上传到智单通 OSS 存储
• get_mcp_server_info: 获取服务状态和配置信息
• 代理上传模式，不存储任何 OSS 密钥
• 本地缓存机制，8小时自动刷新
• npx 自动升级：每次启动自动获取最新版本

支持的文件类型

图片：jpg, jpeg, png, gif, webp 文档：pdf, xlsx, xls, doc, docx 最大文件大小：10MB

安装

方式一：npx（推荐，自动升级）

无需安装，Agent 客户端直接使用 npx 运行：

npx @raiseinfo/smartorder-stdio-mcp

方式二：全局安装

npm install -g @raiseinfo/smartorder-stdio-mcp

配置

环境变量

| 变量 | 说明 | 示例 | 必填 | |------|------|------|------| | TENANT_CODE | 租户编码 | TC1773503403286M2IQ63TB | ✅ | | MCP_TOKEN | MCP访问令牌 | MCP710710AEDF1A4C51850B990F524BFEA5 | ✅ | | SMARTORDER_API_BASE | API基础地址（可选） | https://smart-order.raiseinfo.cn | ❌ | | SMARTORDER_CACHE_DIR | 缓存目录（可选） | ~/.smartorder-stdio/ | ❌ |

使用

Wordbobby / OpenClaw 配置

{
  "mcpServers": {
    "smartorder-file": {
      "command": "npx",
      "args": ["@raiseinfo/smartorder-stdio-mcp"],
      "env": {
        "TENANT_CODE": "你的租户编码",
        "MCP_TOKEN": "你的MCP令牌"
      }
    }
  }
}

Claude Desktop 配置

{
  "mcpServers": {
    "smartorder-file": {
      "command": "npx",
      "args": ["@raiseinfo/smartorder-stdio-mcp"],
      "env": {
        "TENANT_CODE": "${TENANT_CODE}",
        "MCP_TOKEN": "${MCP_TOKEN}"
      }
    }
  }
}

npx 自动升级机制

采用 npx 方案实现自动升级，每次启动 Agent 时自动获取最新版本：

┌──────────────────────────────────────────────────────────────┐
│                    npx 工作流程                               │
└──────────────────────────────────────────────────────────────┘

1. Agent 启动 stdio MCP Server

2. npx 检查本地缓存是否过期

3. 如果有新版本：
   - 首次运行：下载最新版本到缓存
   - 后续运行：直接使用缓存（快速启动）

4. 如果是最新版本：
   - 直接使用缓存运行

优势：

• 无需手动升级，发布新版本后自动生效
• 缓存机制保证后续启动速度
• 无需维护更新逻辑

工具说明

upload_local_file

读取本地文件并上传到智单通存储服务。

参数：

• file_path: 本地文件绝对路径（必填）
• folder: 存储目录（可选，默认 smart-order/）

返回：

• url: 文件访问URL
• md5: 文件MD5哈希值
• fileName: 原始文件名

get_mcp_server_info

获取智单通MCP文件上传服务的基本信息。

返回：

• name: 服务名称
• version: 版本号
• supportedTypes: 支持的文件类型
• maxFileSize: 最大文件大小
• apiBase: API基础地址

开发

# 安装依赖
npm install

# 开发模式
npm run dev

# 构建
npm run build

# 测试
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node dist/index.js

许可

MIT