FlexOrch MCP

flexorch-mcp

FlexOrch 的 MCP 服务——面向机器的 SDK。

将 Claude 和其他兼容 MCP 的 Agent 连接到 FlexOrch 文档智能处理流水线。通过自然语言工具调用处理文档、提取结构化数据、检测 PII，并导出适用于大模型的数据集。

---

这是什么

flexorch-mcp 是一个轻量级代理，可将 FlexOrch API 封装为 MCP 工具。所有处理都在 FlexOrch 的托管基础设施上进行。使用此服务需要 FlexOrch 账户和 API 密钥。

**供编写代码的开发者使用：**使用 flexorch-sdk（Python）或 flexorch-sdk-js（TypeScript）。
**供 Agent 使用：**使用此软件包。

---

工具

工具	描述
document.process	上传并处理文档（PDF、DOCX、TXT、XLSX、HTML、XML、EML、JPG、PNG、TIFF）
document.reprocess	将已上传的文档重新放入流水线处理队列
job.status	轮询处理任务，直到完成或失败
job.result	获取已完成任务中提取的结构化字段
dataset.build	根据已完成的执行构建结构化数据集
dataset.search	跨已索引数据集进行语义搜索（Pro+）
dataset.export	将数据集导出为 JSONL、CSV、JSON、XML、MD 或 RAG 格式（LangChain/LlamaIndex 分块）
dataset.index	为数据集启动语义向量索引（Pro+）
dataset.chunks	从已索引的数据集中获取分页的 RAG 就绪文本块（Pro+）

---

安装

pip install flexorch-mcp

需要 Python 3.10+。

---

配置

Claude Desktop

将以下内容添加到 Claude Desktop 配置文件中（如果文件不存在，请创建）：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "flexorch": {
      "command": "flexorch-mcp",
      "env": {
        "FLEXORCH_API_KEY": "dfx_your_key_here"
      }
    }
  }
}

Cursor

添加到 Cursor MCP 配置中：

{
  "flexorch": {
    "command": "flexorch-mcp",
    "env": {
      "FLEXORCH_API_KEY": "dfx_your_key_here"
    }
  }
}

OpenAI Codex

添加到 ~/.codex/config.toml：

[mcp_servers.flexorch]
command = "uvx"
args = ["flexorch-mcp"]

[mcp_servers.flexorch.env]
FLEXORCH_API_KEY = "dfx_your_key_here"

从 app.flexorch.com/settings 获取 API 密钥。

---

验证连接

flexorch-mcp --check
# → FlexOrch API key: dfx_xxx*** ✓
# → Connection: OK (api.flexorch.com)
# → Plan: Starter (1,200 credits/mo)
# → Tools: 9 registered

---

Agent 工作流示例

User: "Process this invoice and export it as JSONL for fine-tuning."

Agent:
  1. document.process(file_url="https://...")   → job_id: 1234
  2. job.status(1234)                           → completed, execution_id: 567
  3. job.result(567)                            → vendor, total, date, PII masked
  4. dataset.build(execution_id=567)            → job_id: 1235
  5. job.status(1235)                           → completed, dataset_id: 89
  6. dataset.export(89, format="jsonl")         → inline JSONL content

---

套餐限制

所有 FlexOrch 套餐限制均适用于 MCP 工具调用。每处理一份文档都会消耗额度。

套餐	每月额度	语义搜索
试用版	1,200（30 天）	—
入门版	1,200	—
Pro	6,000	✓
企业版	自定义	✓

---

安全

• API 密钥从 FLEXORCH_API_KEY 环境变量中读取，不会作为工具参数传递
• 此服务不存储或缓存任何数据，是无状态代理
• 返回结果前，FlexOrch 流水线会对 PII 进行屏蔽
• 与 api.flexorch.com 的所有通信均使用 HTTPS

---

相关项目

• flexorch-audit — 独立的个人身份信息检测和文档质量评分（无需账户）
• flexorch-sdk — 面向开发者的 Python SDK
• flexorch-sdk-js — 面向开发者的 TypeScript SDK
• docs.flexorch.com — 完整文档

---

许可证

MIT — 请参阅 LICENSE。