Open Enterprise AI MCP Server
Officialby enthrium
README.md
<div align="center">
<h1>Open Enthrium AI MCP Server</h1>
<h3>Enterprise MCP Server · Apache-2.0 · Claude Code · Cursor · Windsurf · Codex · Claude Desktop · VS Code</h3>
**Connect any AI coding assistant to your enterprise data — databases, files, APIs, and more — via a single binary.**
[](LICENSE)
[](https://github.com/enthrium/open-enthrium-ai-mcp-server/releases)
[](https://github.com/enthrium/open-enthrium-ai-mcp-server/releases/latest/download/oe-mcp-win.exe)
[](https://github.com/enthrium/open-enthrium-ai-mcp-server/releases/latest/download/oe-mcp-linux)
[](https://github.com/enthrium/open-enthrium-ai-mcp-server/releases/latest/download/oe-mcp-macos)
[](https://www.npmjs.com/package/@openenthrium/oe-mcp)
[](https://www.openenthrium.com)
</div>
---
## What is OE MCP Server?
A standalone binary that implements the [Model Context Protocol (MCP)](https://modelcontextprotocol.io) and exposes your enterprise data sources as tools that AI apps can use directly. No code. Define connectors in a single JSON file.
- **45+ connector categories** — PostgreSQL, MongoDB, S3, GitHub, Slack, Gmail, SSH, REST API, and more
- **Two transport modes** — `--stdio` for Claude Code / Cursor / Windsurf; `--serve` for cloud or team deployments
- **Persistent memory** — `memory_set / memory_get / memory_list / memory_delete` survive across sessions
- **Action log** — every connector call logged automatically with timestamp, tool, input, and result
- **Run AI agents** — `run_agent` executes any OE Runtime SKILL.md agent directly from Claude Code, Cursor, or any MCP client. Manual skills pause for approval via `approve_chain`.
- **Self-hosted** — runs on your own machine, no cloud dependency, no call-home
---
## Quick Start via npm (Recommended)
**1. Create `oe-mcp.json`:**
```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. Add to your AI app's MCP config:**
macOS / Linux:
```json
{
"mcpServers": {
"oe-mcp": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@openenthrium/oe-mcp", "--stdio", "/path/to/oe-mcp.json"]
}
}
}
```
Windows:
```json
{
"mcpServers": {
"oe-mcp": {
"type": "stdio",
"command": "npx.cmd",
"args": ["-y", "@openenthrium/oe-mcp", "--stdio", "C:\\path\\to\\oe-mcp.json"]
}
}
}
```
> **`-y` is required** — without it npx blocks waiting for keyboard input and the MCP connection never opens.
**3. Reload your AI app** — connectors appear as tools automatically.
Ask Claude: _"What connectors do you have access to?"_ to verify.
---
## Download (Standalone Binary)
| Platform | Binary |
|---|---|
| **Windows** | [oe-mcp-win.exe](https://github.com/enthrium/open-enthrium-ai-mcp-server/releases/latest/download/oe-mcp-win.exe) |
| **Linux** | [oe-mcp-linux](https://github.com/enthrium/open-enthrium-ai-mcp-server/releases/latest/download/oe-mcp-linux) |
| **macOS** | [oe-mcp-macos](https://github.com/enthrium/open-enthrium-ai-mcp-server/releases/latest/download/oe-mcp-macos) |
| **Sample configs** | [oe-mcp-samples.zip](https://github.com/enthrium/open-enthrium-ai-mcp-server/releases/latest/download/oe-mcp-samples.zip) |
---
## Built-in Tools
### Memory
Persistent memory that survives restarts — stored in `oe-mcp-memory.json`:
| Tool | Description |
|---|---|
| `memory_set` | Store a key-value pair across sessions |
| `memory_get` | Retrieve a stored value by key |
| `memory_list` | List all stored key-value pairs |
| `memory_delete` | Remove a stored key |
> _"Remember that our production database is on prod-db.company.com"_ → Claude calls `memory_set`
### Action Log
Every connector call is logged automatically to `oe-mcp-log.json`:
| Tool | Description |
|---|---|
| `log_list` | List recent connector calls (newest first, supports `limit`) |
| `log_clear` | Clear all log entries |
### Run AI Agents
Execute OE Runtime SKILL.md agents or YAML agents directly from Claude Code, Cursor, or any MCP client — no terminal required:
| Tool | Description |
|---|---|
| `run_agent` | Run an agent by file path. Auto skills execute immediately; manual skills pause and return `pending_skill_chain`. |
| `list_pending_skills` | List all manual skills currently paused and waiting for approval |
| `approve_chain` | Approve, skip, or abort a paused manual skill by `chain_id` |
**`run_agent` parameters:**
| Parameter | Required | Description |
|---|---|---|
| `file` | ✅ | Absolute path to `agent.yaml` |
| `params` | ❌ | Key-value pairs substituted via `{{key}}` in the agent |
| `input` | ❌ | Optional initial message passed to the agent |
**`approve_chain` parameters:**
| Parameter | Required | Description |
|---|---|---|
| `chain_id` | ✅ | From `pending_skill_chain.chain_id` in a `run_agent` response |
| `approved` | ❌ | `true` to run the skill (default), `false` to skip it and continue |
| `abort` | ❌ | `true` to stop the entire pipeline immediately |
OE MCP looks for `oe-config.json` in the agent's directory first, then falls back to `oe-mcp.json`.
### Agent Skill Approval Flow
When an agent's skill pipeline includes manual skills, Claude handles the approval loop automatically:
1. Claude calls `run_agent` → response shows `⏸ Skill awaiting approval` with `chain_id` and `skill_name`
2. Claude decides — based on your instructions — whether to approve, skip, or abort
3. Claude calls `approve_chain` → next skill runs or the next manual skill pauses again
4. Repeat until `Pipeline complete` or Claude aborts
Example instruction to Claude Code: _"Run the OE Skills orchestrator and send a Slack message — skip anything you can't do, abort if it asks for credentials."_
---
## Transport Modes
| Mode | Flag | Best for |
|---|---|---|
| **stdio** | `--stdio` | Claude Code, Cursor, Windsurf, Codex, Claude Desktop — launched as child process |
| **HTTP** | `--serve --port 4040` | Cloud deployments, sharing one server across a team |
HTTP mode — start the server, then add the URL to Cursor / Windsurf / Claude Desktop:
```bash
oe-mcp-linux --serve --port 4040 /path/to/oe-mcp.json
# → http://your-server.com:4040/mcp
```
---
## Sample Configs
Download [oe-mcp-samples.zip](https://github.com/enthrium/open-enthrium-ai-mcp-server/releases/latest/download/oe-mcp-samples.zip) — ready-to-use `oe-mcp.json` for common connectors:
`postgres` · `mysql` · `mongodb` · `github` · `slack` · `gdrive` · `ssh` · `filesystem` · `oracle` · `salesforce` · `servicenow` · `telegram` · `notion` · `confluence` · `graphql` · `zoho-mail` · `sftp` · `dropbox` · `multi-connector`
---
## Part of Open Enthrium
| | |
|---|---|
| ⚡ **Agent Runtime** | [open-enthrium-ai-agent-runtime](https://github.com/enthrium/open-enthrium-ai-agent-runtime) — run SKILL.md agents as CLI or HTTP server |
| 🖥️ **Platform** | [open-enthrium-ai-platform](https://github.com/enthrium/open-enthrium-ai-platform) — full web app with workspaces, RAG, Agent Builder |
| 🌐 **Website** | [openenthrium.com](https://www.openenthrium.com) |
---
## Contributing
→ See **[CONTRIBUTING.md](CONTRIBUTING.md)** for how to add sample configs and connector adapters.
---
## License
[Apache-2.0](LICENSE) — free to use, modify, and deploy for any purpose, including commercial use.
No usage limits. No telemetry. No call-home.
---
<div align="center">
**[⭐ Star this repo](https://github.com/enthrium/open-enthrium-ai-mcp-server)** · **[🌐 Website](https://www.openenthrium.com)** · **[⚡ Agent Runtime](https://github.com/enthrium/open-enthrium-ai-agent-runtime)**
</div>
This server cannot be deployed
Maintenance
ActivityActive
ResponsivenessWithin a week