@raiseinfo/smartorder-stdio-mcp 1.0.0

package/README.md

@@ -0,0 +1,152 @@
+# @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 运行：
+
+```bash
+npx @raiseinfo/smartorder-stdio-mcp
+```
+
+### 方式二：全局安装
+
+```bash
+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 配置
+
+```json
+{
+  "mcpServers": {
+    "smartorder-file": {
+      "command": "npx",
+      "args": ["@raiseinfo/smartorder-stdio-mcp"],
+      "env": {
+        "TENANT_CODE": "你的租户编码",
+        "MCP_TOKEN": "你的MCP令牌"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop 配置
+
+```json
+{
+  "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基础地址
+
+## 开发
+
+```bash
+# 安装依赖
+npm install
+
+# 开发模式
+npm run dev
+
+# 构建
+npm run build
+
+# 测试
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node dist/index.js
+```
+
+## 许可
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { uploadLocalFileTool, handleUpload } from './tools/file-upload.js';
+import { serverInfoTool, handleServerInfo } from './tools/server-info.js';
+const server = new Server({
+    name: 'smartorder-stdio-mcp',
+    version: '1.0.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [uploadLocalFileTool, serverInfoTool],
+    };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case 'upload_local_file':
+                return await handleUpload(args);
+            case 'get_mcp_server_info':
+                return await handleServerInfo();
+            default:
+                return {
+                    content: [{ type: 'text', text: `未知工具：${name}` }],
+                    isError: true,
+                };
+        }
+    }
+    catch (error) {
+        return {
+            content: [{ type: 'text', text: error.message }],
+            isError: true,
+        };
+    }
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/dist/tools/file-upload.d.ts

@@ -0,0 +1,9 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const uploadLocalFileTool: Tool;
+export declare function handleUpload(args: {
+    file_path: string;
+    folder?: string;
+}): Promise<{
+    content: any[];
+    isError?: boolean;
+}>;

package/dist/tools/file-upload.js

@@ -0,0 +1,107 @@
+import { CacheManager } from '../utils/cache.js';
+import { HttpClient } from '../utils/http-client.js';
+import { FileReader } from '../utils/file-reader.js';
+const cacheManager = new CacheManager();
+const httpClient = new HttpClient();
+const fileReader = new FileReader();
+export const uploadLocalFileTool = {
+    name: 'upload_local_file',
+    description: `读取本地文件并上传到智单通存储服务（代理上传模式）。
+
+【工作流程】
+1. 验证本地文件（存在、大小、类型）
+2. 使用缓存的API配置上传
+3. 上传失败时根据错误码处理（404立即报错，5xx重试1次）
+
+【安全说明】
+- 采用代理上传模式，不存储任何OSS密钥
+- 文件通过后端服务转存到OSS
+
+【支持的文件类型】
+- 图片：jpg, jpeg, png, gif, webp
+- 文档：pdf, xlsx, xls, doc, docx
+- 最大文件大小：10MB`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            file_path: {
+                type: 'string',
+                description: '本地文件绝对路径，如 /Users/ken/orders/file.xlsx',
+            },
+            folder: {
+                type: 'string',
+                description: 'OSS存储目录',
+                default: 'smart-order/',
+            },
+        },
+        required: ['file_path'],
+    },
+};
+export async function handleUpload(args) {
+    const { file_path, folder = 'smart-order/' } = args;
+    await fileReader.validate(file_path);
+    let apiUrl;
+    let cache = await cacheManager.load();
+    if (cache && !cacheManager.isExpired(cache)) {
+        apiUrl = cache.apiUrl;
+    }
+    else {
+        try {
+            const config = await httpClient.getConfig();
+            apiUrl = config.data.apiUrl;
+            await cacheManager.save({
+                version: 1,
+                apiUrl: config.data.apiUrl,
+                folder: config.data.folder,
+                prefix: config.data.prefix,
+                tenantCode: process.env.TENANT_CODE || '',
+                expiresIn: config.data.expiresIn,
+                obtainedAt: Date.now(),
+                expiresAt: Date.now() + config.data.expiresIn * 1000,
+            });
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `获取配置失败：${error.message}` }],
+                isError: true,
+            };
+        }
+    }
+    try {
+        const result = await httpClient.uploadFile(file_path, folder);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result.data, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        if (error.message.includes('404')) {
+            return {
+                content: [{ type: 'text', text: error.message }],
+                isError: true,
+            };
+        }
+        if (error.message.includes('5xx') || error.message.includes('网络')) {
+            try {
+                const result = await httpClient.uploadFile(file_path, folder);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }],
+                };
+            }
+            catch {
+                return {
+                    content: [{ type: 'text', text: '服务暂时不可用，请稍后重试' }],
+                    isError: true,
+                };
+            }
+        }
+        return {
+            content: [{ type: 'text', text: error.message }],
+            isError: true,
+        };
+    }
+}

package/dist/tools/server-info.d.ts

@@ -0,0 +1,5 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const serverInfoTool: Tool;
+export declare function handleServerInfo(): Promise<{
+    content: any[];
+}>;

package/dist/tools/server-info.js

@@ -0,0 +1,32 @@
+export const serverInfoTool = {
+    name: 'get_mcp_server_info',
+    description: `获取智单通MCP文件上传服务的基本信息。
+
+【返回信息】
+- 服务名称和版本
+- 支持的文件类型
+- 最大文件大小
+- 当前连接状态
+- 缓存状态`,
+    inputSchema: {
+        type: 'object',
+        properties: {},
+    },
+};
+export async function handleServerInfo() {
+    const info = {
+        name: '智单通文件上传服务',
+        version: '1.0.0',
+        supportedTypes: ['jpg', 'jpeg', 'png', 'gif', 'webp', 'pdf', 'xlsx', 'xls', 'doc', 'docx'],
+        maxFileSize: '10MB',
+        apiBase: process.env.SMARTORDER_API_BASE || 'https://smart-order.raiseinfo.cn',
+    };
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(info, null, 2),
+            },
+        ],
+    };
+}

package/dist/types/index.d.ts

@@ -0,0 +1,41 @@
+export interface ApiCache {
+    version: number;
+    apiUrl: string;
+    folder: string;
+    prefix: string;
+    tenantCode: string;
+    expiresIn: number;
+    expiresAt: number;
+    obtainedAt: number;
+}
+export interface UploadConfig {
+    apiUrl: string;
+    folder: string;
+    prefix: string;
+    maxFileSize: number;
+    allowedTypes: string[];
+    expiresIn: number;
+}
+export interface UploadResult {
+    url: string;
+    fileName: string;
+    size: number;
+    md5: string;
+}
+export interface McpConfigResponse {
+    code: number;
+    msg?: string;
+    data: UploadConfig;
+}
+export interface McpUploadResponse {
+    code: number;
+    msg?: string;
+    data: UploadResult;
+}
+export interface ServerInfo {
+    name: string;
+    version: string;
+    supportedTypes: string[];
+    maxFileSize: string;
+    apiBase: string;
+}

package/dist/types/index.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/cache.d.ts

@@ -0,0 +1,10 @@
+import { ApiCache } from '../types/index.js';
+export declare class CacheManager {
+    private cacheDir;
+    private cacheFile;
+    constructor();
+    load(): Promise<ApiCache | null>;
+    save(cache: ApiCache): Promise<void>;
+    clear(): Promise<void>;
+    isExpired(cache: ApiCache): boolean;
+}

package/dist/utils/cache.js

@@ -0,0 +1,46 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+const CACHE_FILE = 'api-cache.json';
+const CACHE_VERSION = 1;
+export class CacheManager {
+    cacheDir;
+    cacheFile;
+    constructor() {
+        const baseDir = process.env.SMARTORDER_CACHE_DIR || path.join(os.homedir(), '.smartorder-stdio');
+        this.cacheDir = baseDir;
+        this.cacheFile = path.join(baseDir, CACHE_FILE);
+    }
+    async load() {
+        await fs.promises.mkdir(this.cacheDir, { recursive: true });
+        try {
+            const data = await fs.promises.readFile(this.cacheFile, 'utf-8');
+            const cache = JSON.parse(data);
+            if (cache.version !== CACHE_VERSION) {
+                return null;
+            }
+            return cache;
+        }
+        catch {
+            return null;
+        }
+    }
+    async save(cache) {
+        await fs.promises.mkdir(this.cacheDir, { recursive: true });
+        cache.version = CACHE_VERSION;
+        cache.obtainedAt = Date.now();
+        cache.expiresAt = Date.now() + (cache.expiresIn || 28800) * 1000;
+        await fs.promises.writeFile(this.cacheFile, JSON.stringify(cache, null, 2));
+    }
+    async clear() {
+        try {
+            await fs.promises.unlink(this.cacheFile);
+        }
+        catch {
+            // 忽略错误
+        }
+    }
+    isExpired(cache) {
+        return Date.now() > cache.expiresAt;
+    }
+}

package/dist/utils/file-reader.d.ts

@@ -0,0 +1,6 @@
+export declare class FileReader {
+    validate(filePath: string): Promise<void>;
+    readAsBase64(filePath: string): Promise<string>;
+    getFileName(filePath: string): string;
+    getFileSize(filePath: string): number;
+}

package/dist/utils/file-reader.js

@@ -0,0 +1,35 @@
+import fs from 'fs';
+import path from 'path';
+const ALLOWED_TYPES = ['jpg', 'jpeg', 'png', 'gif', 'webp', 'pdf', 'xlsx', 'xls', 'doc', 'docx'];
+const MAX_FILE_SIZE = 10 * 1024 * 1024;
+export class FileReader {
+    async validate(filePath) {
+        try {
+            await fs.promises.access(filePath, fs.constants.R_OK);
+        }
+        catch {
+            throw new Error(`文件不存在：${filePath}，请检查路径是否正确`);
+        }
+        const stats = await fs.promises.stat(filePath);
+        if (!stats.isFile()) {
+            throw new Error(`路径不是文件：${filePath}`);
+        }
+        if (stats.size > MAX_FILE_SIZE) {
+            throw new Error(`文件大小超过限制（最大10MB）：${stats.size} bytes`);
+        }
+        const ext = path.extname(filePath).toLowerCase().replace('.', '');
+        if (!ALLOWED_TYPES.includes(ext)) {
+            throw new Error(`不支持的文件类型：.${ext}，支持：${ALLOWED_TYPES.join(', ')}`);
+        }
+    }
+    async readAsBase64(filePath) {
+        const buffer = await fs.promises.readFile(filePath);
+        return buffer.toString('base64');
+    }
+    getFileName(filePath) {
+        return path.basename(filePath);
+    }
+    getFileSize(filePath) {
+        return fs.statSync(filePath).size;
+    }
+}

package/dist/utils/http-client.d.ts

@@ -0,0 +1,10 @@
+import { McpConfigResponse, McpUploadResponse } from '../types/index.js';
+export declare class HttpClient {
+    private baseUrl;
+    private tenantCode;
+    private mcpToken;
+    constructor();
+    getConfig(): Promise<McpConfigResponse>;
+    uploadFile(filePath: string, folder: string): Promise<McpUploadResponse>;
+    private request;
+}

package/dist/utils/http-client.js

@@ -0,0 +1,81 @@
+import fs from 'fs';
+import path from 'path';
+import FormData from 'form-data';
+import http from 'http';
+import https from 'https';
+export class HttpClient {
+    baseUrl;
+    tenantCode;
+    mcpToken;
+    constructor() {
+        this.baseUrl = process.env.SMARTORDER_API_BASE || 'https://smart-order.raiseinfo.cn';
+        this.tenantCode = process.env.TENANT_CODE || '';
+        this.mcpToken = process.env.MCP_TOKEN || '';
+    }
+    async getConfig() {
+        const url = `${this.baseUrl}/api/mcp/config`;
+        return this.request('GET', url);
+    }
+    async uploadFile(filePath, folder) {
+        const url = `${this.baseUrl}/api/mcp/upload`;
+        const form = new FormData();
+        const fileStream = fs.createReadStream(filePath);
+        const fileName = path.basename(filePath);
+        form.append('file', fileStream, { filename: fileName });
+        form.append('folder', folder);
+        return this.request('POST', url, form, true);
+    }
+    request(method, url, body, isFormData = false) {
+        return new Promise((resolve, reject) => {
+            const urlObj = new URL(url);
+            const client = urlObj.protocol === 'https:' ? https : http;
+            const options = {
+                hostname: urlObj.hostname,
+                port: urlObj.port || (urlObj.protocol === 'https:' ? 443 : 80),
+                path: urlObj.pathname,
+                method,
+                headers: {
+                    'X-Tenant-Code': this.tenantCode,
+                    'X-Mcp-Token': this.mcpToken,
+                    ...(isFormData ? body.getHeaders() : { 'Content-Type': 'application/json' }),
+                },
+            };
+            const req = client.request(options, (res) => {
+                let data = '';
+                res.on('data', (chunk) => (data += chunk));
+                res.on('end', () => {
+                    try {
+                        const json = JSON.parse(data);
+                        if (res.statusCode === 200) {
+                            resolve(json);
+                        }
+                        else if (res.statusCode === 401 || res.statusCode === 403) {
+                            reject(new Error('认证失败，请检查租户Token配置'));
+                        }
+                        else if (res.statusCode === 404) {
+                            reject(new Error('上传服务路径不存在，请联系管理员'));
+                        }
+                        else {
+                            reject(new Error(`服务返回错误：${res.statusCode}`));
+                        }
+                    }
+                    catch {
+                        reject(new Error('响应解析失败'));
+                    }
+                });
+            });
+            req.on('error', (err) => {
+                reject(new Error(`网络错误：${err.message}`));
+            });
+            if (body) {
+                if (isFormData) {
+                    body.pipe(req);
+                }
+                else {
+                    req.write(JSON.stringify(body));
+                }
+            }
+            req.end();
+        });
+    }
+}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@raiseinfo/smartorder-stdio-mcp",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "智单通文件上传 MCP Server (stdio模式)",
+  "bin": {
+    "smartorder-stdio-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "postbuild": "node -e \"const fs=require('fs');const f='dist/index.js';let c=fs.readFileSync(f,'utf8');if(!c.startsWith('#!')){fs.writeFileSync(f,'#!/usr/bin/env node\\n'+c);}\"",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "form-data": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,49 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { uploadLocalFileTool, handleUpload } from './tools/file-upload.js';
+import { serverInfoTool, handleServerInfo } from './tools/server-info.js';
+
+const server = new Server(
+  {
+    name: 'smartorder-stdio-mcp',
+    version: '1.0.0',
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [uploadLocalFileTool, serverInfoTool],
+  };
+});
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  try {
+    switch (name) {
+      case 'upload_local_file':
+        return await handleUpload(args as { file_path: string; folder?: string });
+      case 'get_mcp_server_info':
+        return await handleServerInfo();
+      default:
+        return {
+          content: [{ type: 'text', text: `未知工具：${name}` }],
+          isError: true,
+        };
+    }
+  } catch (error: any) {
+    return {
+      content: [{ type: 'text', text: error.message }],
+      isError: true,
+    };
+  }
+});
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/src/tools/file-upload.ts

@@ -0,0 +1,115 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { CacheManager } from '../utils/cache.js';
+import { HttpClient } from '../utils/http-client.js';
+import { FileReader } from '../utils/file-reader.js';
+
+const cacheManager = new CacheManager();
+const httpClient = new HttpClient();
+const fileReader = new FileReader();
+
+export const uploadLocalFileTool: Tool = {
+  name: 'upload_local_file',
+  description: `读取本地文件并上传到智单通存储服务（代理上传模式）。
+
+【工作流程】
+1. 验证本地文件（存在、大小、类型）
+2. 使用缓存的API配置上传
+3. 上传失败时根据错误码处理（404立即报错，5xx重试1次）
+
+【安全说明】
+- 采用代理上传模式，不存储任何OSS密钥
+- 文件通过后端服务转存到OSS
+
+【支持的文件类型】
+- 图片：jpg, jpeg, png, gif, webp
+- 文档：pdf, xlsx, xls, doc, docx
+- 最大文件大小：10MB`,
+
+  inputSchema: {
+    type: 'object',
+    properties: {
+      file_path: {
+        type: 'string',
+        description: '本地文件绝对路径，如 /Users/ken/orders/file.xlsx',
+      },
+      folder: {
+        type: 'string',
+        description: 'OSS存储目录',
+        default: 'smart-order/',
+      },
+    },
+    required: ['file_path'],
+  },
+};
+
+export async function handleUpload(args: { file_path: string; folder?: string }): Promise<{ content: any[]; isError?: boolean }> {
+  const { file_path, folder = 'smart-order/' } = args;
+
+  await fileReader.validate(file_path);
+
+  let apiUrl: string;
+  let cache = await cacheManager.load();
+
+  if (cache && !cacheManager.isExpired(cache)) {
+    apiUrl = cache.apiUrl;
+  } else {
+    try {
+      const config = await httpClient.getConfig();
+      apiUrl = config.data.apiUrl;
+
+      await cacheManager.save({
+        version: 1,
+        apiUrl: config.data.apiUrl,
+        folder: config.data.folder,
+        prefix: config.data.prefix,
+        tenantCode: process.env.TENANT_CODE || '',
+        expiresIn: config.data.expiresIn,
+        obtainedAt: Date.now(),
+        expiresAt: Date.now() + config.data.expiresIn * 1000,
+      });
+    } catch (error: any) {
+      return {
+        content: [{ type: 'text', text: `获取配置失败：${error.message}` }],
+        isError: true,
+      };
+    }
+  }
+
+  try {
+    const result = await httpClient.uploadFile(file_path, folder);
+    return {
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(result.data, null, 2),
+        },
+      ],
+    };
+  } catch (error: any) {
+    if (error.message.includes('404')) {
+      return {
+        content: [{ type: 'text', text: error.message }],
+        isError: true,
+      };
+    }
+
+    if (error.message.includes('5xx') || error.message.includes('网络')) {
+      try {
+        const result = await httpClient.uploadFile(file_path, folder);
+        return {
+          content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }],
+        };
+      } catch {
+        return {
+          content: [{ type: 'text', text: '服务暂时不可用，请稍后重试' }],
+          isError: true,
+        };
+      }
+    }
+
+    return {
+      content: [{ type: 'text', text: error.message }],
+      isError: true,
+    };
+  }
+}

package/src/tools/server-info.ts

@@ -0,0 +1,37 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+
+export const serverInfoTool: Tool = {
+  name: 'get_mcp_server_info',
+  description: `获取智单通MCP文件上传服务的基本信息。
+
+【返回信息】
+- 服务名称和版本
+- 支持的文件类型
+- 最大文件大小
+- 当前连接状态
+- 缓存状态`,
+
+  inputSchema: {
+    type: 'object',
+    properties: {},
+  },
+};
+
+export async function handleServerInfo(): Promise<{ content: any[] }> {
+  const info = {
+    name: '智单通文件上传服务',
+    version: '1.0.0',
+    supportedTypes: ['jpg', 'jpeg', 'png', 'gif', 'webp', 'pdf', 'xlsx', 'xls', 'doc', 'docx'],
+    maxFileSize: '10MB',
+    apiBase: process.env.SMARTORDER_API_BASE || 'https://smart-order.raiseinfo.cn',
+  };
+
+  return {
+    content: [
+      {
+        type: 'text',
+        text: JSON.stringify(info, null, 2),
+      },
+    ],
+  };
+}

package/src/types/index.ts

@@ -0,0 +1,46 @@
+export interface ApiCache {
+  version: number;
+  apiUrl: string;
+  folder: string;
+  prefix: string;
+  tenantCode: string;
+  expiresIn: number;
+  expiresAt: number;
+  obtainedAt: number;
+}
+
+export interface UploadConfig {
+  apiUrl: string;
+  folder: string;
+  prefix: string;
+  maxFileSize: number;
+  allowedTypes: string[];
+  expiresIn: number;
+}
+
+export interface UploadResult {
+  url: string;
+  fileName: string;
+  size: number;
+  md5: string;
+}
+
+export interface McpConfigResponse {
+  code: number;
+  msg?: string;
+  data: UploadConfig;
+}
+
+export interface McpUploadResponse {
+  code: number;
+  msg?: string;
+  data: UploadResult;
+}
+
+export interface ServerInfo {
+  name: string;
+  version: string;
+  supportedTypes: string[];
+  maxFileSize: string;
+  apiBase: string;
+}

package/src/utils/cache.ts

@@ -0,0 +1,55 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { ApiCache } from '../types/index.js';
+
+const CACHE_FILE = 'api-cache.json';
+const CACHE_VERSION = 1;
+
+export class CacheManager {
+  private cacheDir: string;
+  private cacheFile: string;
+
+  constructor() {
+    const baseDir = process.env.SMARTORDER_CACHE_DIR || path.join(os.homedir(), '.smartorder-stdio');
+    this.cacheDir = baseDir;
+    this.cacheFile = path.join(baseDir, CACHE_FILE);
+  }
+
+  async load(): Promise<ApiCache | null> {
+    await fs.promises.mkdir(this.cacheDir, { recursive: true });
+
+    try {
+      const data = await fs.promises.readFile(this.cacheFile, 'utf-8');
+      const cache = JSON.parse(data) as ApiCache;
+
+      if (cache.version !== CACHE_VERSION) {
+        return null;
+      }
+
+      return cache;
+    } catch {
+      return null;
+    }
+  }
+
+  async save(cache: ApiCache): Promise<void> {
+    await fs.promises.mkdir(this.cacheDir, { recursive: true });
+    cache.version = CACHE_VERSION;
+    cache.obtainedAt = Date.now();
+    cache.expiresAt = Date.now() + (cache.expiresIn || 28800) * 1000;
+    await fs.promises.writeFile(this.cacheFile, JSON.stringify(cache, null, 2));
+  }
+
+  async clear(): Promise<void> {
+    try {
+      await fs.promises.unlink(this.cacheFile);
+    } catch {
+      // 忽略错误
+    }
+  }
+
+  isExpired(cache: ApiCache): boolean {
+    return Date.now() > cache.expiresAt;
+  }
+}

package/src/utils/file-reader.ts

@@ -0,0 +1,42 @@
+import fs from 'fs';
+import path from 'path';
+
+const ALLOWED_TYPES = ['jpg', 'jpeg', 'png', 'gif', 'webp', 'pdf', 'xlsx', 'xls', 'doc', 'docx'];
+const MAX_FILE_SIZE = 10 * 1024 * 1024;
+
+export class FileReader {
+  async validate(filePath: string): Promise<void> {
+    try {
+      await fs.promises.access(filePath, fs.constants.R_OK);
+    } catch {
+      throw new Error(`文件不存在：${filePath}，请检查路径是否正确`);
+    }
+
+    const stats = await fs.promises.stat(filePath);
+    if (!stats.isFile()) {
+      throw new Error(`路径不是文件：${filePath}`);
+    }
+
+    if (stats.size > MAX_FILE_SIZE) {
+      throw new Error(`文件大小超过限制（最大10MB）：${stats.size} bytes`);
+    }
+
+    const ext = path.extname(filePath).toLowerCase().replace('.', '');
+    if (!ALLOWED_TYPES.includes(ext)) {
+      throw new Error(`不支持的文件类型：.${ext}，支持：${ALLOWED_TYPES.join(', ')}`);
+    }
+  }
+
+  async readAsBase64(filePath: string): Promise<string> {
+    const buffer = await fs.promises.readFile(filePath);
+    return buffer.toString('base64');
+  }
+
+  getFileName(filePath: string): string {
+    return path.basename(filePath);
+  }
+
+  getFileSize(filePath: string): number {
+    return fs.statSync(filePath).size;
+  }
+}

package/src/utils/http-client.ts

@@ -0,0 +1,95 @@
+import fs from 'fs';
+import path from 'path';
+import FormData from 'form-data';
+import http from 'http';
+import https from 'https';
+import { McpConfigResponse, McpUploadResponse } from '../types/index.js';
+
+export class HttpClient {
+  private baseUrl: string;
+  private tenantCode: string;
+  private mcpToken: string;
+
+  constructor() {
+    this.baseUrl = process.env.SMARTORDER_API_BASE || 'https://smart-order.raiseinfo.cn';
+    this.tenantCode = process.env.TENANT_CODE || '';
+    this.mcpToken = process.env.MCP_TOKEN || '';
+  }
+
+  async getConfig(): Promise<McpConfigResponse> {
+    const url = `${this.baseUrl}/api/mcp/config`;
+    return this.request('GET', url) as Promise<McpConfigResponse>;
+  }
+
+  async uploadFile(filePath: string, folder: string): Promise<McpUploadResponse> {
+    const url = `${this.baseUrl}/api/mcp/upload`;
+    const form = new FormData();
+
+    const fileStream = fs.createReadStream(filePath);
+    const fileName = path.basename(filePath);
+
+    form.append('file', fileStream, { filename: fileName });
+    form.append('folder', folder);
+
+    return this.request('POST', url, form, true) as Promise<McpUploadResponse>;
+  }
+
+  private request(
+    method: string,
+    url: string,
+    body?: any,
+    isFormData: boolean = false
+  ): Promise<any> {
+    return new Promise((resolve, reject) => {
+      const urlObj = new URL(url);
+      const client = urlObj.protocol === 'https:' ? https : http;
+
+      const options: http.RequestOptions = {
+        hostname: urlObj.hostname,
+        port: urlObj.port || (urlObj.protocol === 'https:' ? 443 : 80),
+        path: urlObj.pathname,
+        method,
+        headers: {
+          'X-Tenant-Code': this.tenantCode,
+          'X-Mcp-Token': this.mcpToken,
+          ...(isFormData ? body.getHeaders() : { 'Content-Type': 'application/json' }),
+        },
+      };
+
+      const req = client.request(options, (res) => {
+        let data = '';
+        res.on('data', (chunk) => (data += chunk));
+        res.on('end', () => {
+          try {
+            const json = JSON.parse(data);
+            if (res.statusCode === 200) {
+              resolve(json);
+            } else if (res.statusCode === 401 || res.statusCode === 403) {
+              reject(new Error('认证失败，请检查租户Token配置'));
+            } else if (res.statusCode === 404) {
+              reject(new Error('上传服务路径不存在，请联系管理员'));
+            } else {
+              reject(new Error(`服务返回错误：${res.statusCode}`));
+            }
+          } catch {
+            reject(new Error('响应解析失败'));
+          }
+        });
+      });
+
+      req.on('error', (err) => {
+        reject(new Error(`网络错误：${err.message}`));
+      });
+
+      if (body) {
+        if (isFormData) {
+          body.pipe(req);
+        } else {
+          req.write(JSON.stringify(body));
+        }
+      }
+
+      req.end();
+    });
+  }
+}

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}