Foxit Cloudapi

MCP指南

环境变量列表

• CLIENT_ID:服务API的客户端ID是必需的
• 模式： LOCAL 或 CLOUD，默认值为 LOCAL
• \_ENV_BASE：如果要使用devcn环境，请将其设置为 devcn，是可选的，默认为 prod

快速启动stdio节点

1. 进入 mcp/stdio-node，跑 pnpm i

1. 战略开发，运行 pnpm dev

1. 打开 settings.json 添加以下配置

{
  "mcp": {
    "servers": {
      "mcp-server-foxit-cloudapi": {
          "command": "node",
          "args": [
              "xxx/cloudapisstudio/mcp/stdio-node/build/index.js" // path to your mcp/stdio-python
          ],
          "env": {
              "_ENV_BASE": "devcn",
              "CLIENT_ID": "xxx",
              "MODE": "CLOUD"
          }
      },
    }
  }
}

生产配置

{
  "mcp": {
    "servers": {
      "mcp-server-foxit-cloudapi": {
          "command": "node",
          "args": [
            "-y",
            "@foxitsoftware/mcp-server-foxit-cloudapi"
          ],
          "env": {
              "CLIENT_ID": "xxx",
              "MODE": "CLOUD"
          }
      },
    }
  }
}

发布到NPM

1. 进入 mcp/stdio-node，跑 pnpm build

1. 调整 package.json 版本

1. 跑 npm login

1. 跑 npm publish --access public

快速入门stdio python

1. 进入 mcp/stdio-python，跑 uv sync

1. 打开 settings.json 添加以下配置

{
  "mcp": {
    "servers": {
      "mcp-server-foxit-cloudapi": {
          "command": "uv",
          "args": [
              "--directory",
              "xxx/cloudapisstudio/mcp/stdio-python", // path to your mcp/stdio-python
              "run",
              "main.py",
          ],
          "env": {
              "_ENV_BASE": "devcn",
              "CLIENT_ID": "xxx",
              "MODE": "CLOUD"
          }
      },
    }
  }
}

生产配置

{
  "mcp": {
    "servers": {
      "mcp-server-foxit-cloudapi": {
          "command": "uvx",
          "args": [
              "mcp-server-foxit-cloudapi"
          ],
          "env": {
              "CLIENT_ID": "xxx",
              "MODE": "CLOUD"
          }
      },
    }
  }
}

注意：使用 uvx cache clean 如果需要，清理缓存

发布到PyPI

1. 调整 package.json 版本

1. 删除 mcp/stdio-python/dist 文件夹

1. 进入 mcp/stdio-python，跑 uv build

1. 跑 uv publish --token xxx，从获取令牌https://pypi.org/manage/account/

使用@modelcontextprotocol/检查器

1. 启动检查器，运行 npx @modelcontextprotocol/inspector，如果无法启动，请运行 npm install -g @modelcontextprotocol/inspector 第一

1. 打开检查器网页，然后配置以下内容：

节点

• 设置命令：节点
• 设置参数：xxx/cloudapisstudio/mcp/stdio-node/build/index.js
• 添加环境变量：CLIENT_ID=xxx

python

• 设置命令：uv
• 设置参数：--目录xxx/cloudapisstudio/mcp/stdio python运行main.py
• 添加环境变量：CLIENT_ID=xxx