oe-mcp

---

什么是 OE MCP Server？

这是一个独立的二进制文件，实现了 Model Context Protocol（MCP），并将企业数据源公开为 AI 应用可直接使用的工具。无需编写代码，只需在一个 JSON 文件中定义连接器。

• 45+ 种连接器类别 — PostgreSQL、MongoDB、S3、GitHub、Slack、Gmail、SSH、REST API 等
• 两种传输模式 — --stdio 适用于 Claude Code / Cursor / Windsurf；--serve 适用于云端或团队部署
• 持久化记忆 — memory_set / memory_get / memory_list / memory_delete 可跨会话保留数据
• 操作日志 — 自动记录每次连接器调用的时间戳、工具、输入和结果
• 运行 AI Agent — run_agent 可直接从 Claude Code、Cursor 或任何 MCP 客户端执行任意 OE Runtime SKILL.md Agent。手动技能会暂停，等待通过 approve_chain 批准。
• 可自托管 — 在自己的机器上运行，不依赖云端，也不会回传数据

---

通过 npm 快速开始（推荐）

1. 创建 oe-mcp.json：

{
  "connectors": [
    {
      "name": "my-postgres",
      "type": "postgresql",
      "host": "localhost",
      "port": 5432,
      "database": "mydb",
      "user": "postgres",
      "password": "secret"
    },
    {
      "name": "my-codebase",
      "type": "filesystem",
      "basePath": "/home/user/projects/myapp"
    }
  ],
  "memory": [
    { "key": "project_context", "value": "This is our main application." }
  ]
}

2. 添加到 AI 应用的 MCP 配置中：

macOS / Linux：

{
  "mcpServers": {
    "oe-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@openenthrium/oe-mcp", "--stdio", "/path/to/oe-mcp.json"]
    }
  }
}

Windows：

{
  "mcpServers": {
    "oe-mcp": {
      "type": "stdio",
      "command": "npx.cmd",
      "args": ["-y", "@openenthrium/oe-mcp", "--stdio", "C:\\path\\to\\oe-mcp.json"]
    }
  }
}

必须使用 -y — 否则 npx 会等待键盘输入，MCP 连接将无法建立。

3. 重新加载 AI 应用 — 连接器会自动显示为工具。

向 Claude 提问：“你可以访问哪些连接器？” 以进行验证。

---

下载（独立二进制文件）

平台	二进制文件
Windows	oe-mcp-win.exe
Linux	oe-mcp-linux
macOS	oe-mcp-macos
示例配置	oe-mcp-samples.zip

---

内置工具

记忆

可跨重启保留的持久化记忆——存储在 oe-mcp-memory.json 中：

工具	描述
memory_set	跨会话存储键值对
memory_get	根据键检索已存储的值
memory_list	列出所有已存储的键值对
memory_delete	删除已存储的键

“记住，我们的生产数据库位于 prod-db.company.com” → Claude 调用 memory_set

操作日志

每次连接器调用都会自动记录到 oe-mcp-log.json：

工具	描述
log_list	列出最近的连接器调用（最新的在前，支持 limit）
log_clear	清除所有日志条目

运行 AI Agent

直接从 Claude Code、Cursor 或任何 MCP 客户端执行 OE Runtime SKILL.md Agent 或 YAML Agent，无需使用终端：

工具	描述
run_agent	按文件路径运行 Agent。自动技能会立即执行；手动技能会暂停并返回 pending_skill_chain。
list_pending_skills	列出当前所有已暂停并等待批准的手动技能
approve_chain	按 chain_id 批准、跳过或中止已暂停的手动技能

run_agent 参数：

参数	必填	描述
file	✅	agent.yaml 的绝对路径
params	❌	在 Agent 中通过 {{key}} 替换的键值对
input	❌	传递给 Agent 的可选初始消息

approve_chain 参数：

参数	必填	描述
chain_id	✅	来自 run_agent 响应中的 pending_skill_chain.chain_id
approved	❌	true 表示运行该技能（默认值），false 表示跳过并继续
abort	❌	true 表示立即停止整个流水线

OE MCP 会先在 Agent 所在目录中查找 oe-config.json，找不到时再回退到 oe-mcp.json。

Agent 技能审批流程

当 Agent 的技能流水线包含手动技能时，Claude 会自动处理审批循环：

1. Claude 调用 run_agent → 响应显示 ⏸ Skill awaiting approval，并附带 chain_id 和 skill_name
2. Claude 根据你的指示决定批准、跳过或中止
3. Claude 调用 approve_chain → 运行下一个技能，或再次暂停以等待审批下一个手动技能
4. 重复上述步骤，直到显示 Pipeline complete 或 Claude 中止流程

给 Claude Code 的示例指示：“运行 OE Skills 编排器并发送一条 Slack 消息——跳过无法执行的操作；如果它要求提供凭据，则中止。”

---

传输模式

模式	标志	适用场景
stdio	--stdio	Claude Code、Cursor、Windsurf、Codex、Claude Desktop — 作为子进程启动
HTTP	--serve --port 4040	云部署，供团队共享同一服务

HTTP 模式 — 启动服务，然后将 URL 添加到 Cursor / Windsurf / Claude Desktop：

oe-mcp-linux --serve --port 4040 /path/to/oe-mcp.json
# → http://your-server.com:4040/mcp

---

示例配置

下载 oe-mcp-samples.zip — 获取适用于常见连接器的即用型 oe-mcp.json：

postgres · mysql · mongodb · github · slack · gdrive · ssh · filesystem · oracle · salesforce · servicenow · telegram · notion · confluence · graphql · zoho-mail · sftp · dropbox · multi-connector

---

Open Enthrium 项目的一部分

⚡ Agent Runtime	open-enthrium-ai-agent-runtime — 将 SKILL.md Agent 作为 CLI 或 HTTP 服务运行
🖥️ 平台	open-enthrium-ai-platform — 完整的 Web 应用，包含工作区、RAG、Agent Builder
🌐 网站	openenthrium.com

---

贡献

→ 如何添加示例配置和连接器适配器，请参阅 CONTRIBUTING.md。

---

许可证

Apache-2.0 — 可免费用于任何目的，包括商业用途，也可修改和部署。 没有使用限制。没有遥测。不会主动回连。

---