oe-mcp

---

OE MCP Server とは？

Model Context Protocol (MCP) を実装し、エンタープライズデータソースを AI アプリから直接利用できるツールとして公開するスタンドアロンバイナリです。コードは不要です。単一の JSON ファイルでコネクターを定義します。

• 45 種類以上のコネクターカテゴリ — PostgreSQL、MongoDB、S3、GitHub、Slack、Gmail、SSH、REST API など
• 2 つのトランスポートモード — Claude Code／Cursor／Windsurf 用の --stdio、クラウドまたはチームでのデプロイ用の --serve
• 永続メモリ — memory_set / memory_get / memory_list / memory_delete はセッションをまたいで保持されます
• アクションログ — すべてのコネクター呼び出しが、タイムスタンプ、ツール、入力、結果とともに自動で記録されます
• AI エージェントの実行 — run_agent は、OE Runtime の任意の SKILL.md エージェントを Claude Code、Cursor、または任意の MCP クライアントから直接実行します。手動スキルは、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 エージェントの実行

Claude Code、Cursor、または任意の MCP クライアントから、OE Runtime の SKILL.md エージェントや YAML エージェントを直接実行できます。ターミナルは不要です。

ツール	説明
run_agent	ファイルパスでエージェントを実行します。自動スキルはすぐに実行され、手動スキルは一時停止して pending_skill_chain を返します。
list_pending_skills	現在一時停止し、承認待ちになっているすべての手動スキルを一覧表示します
approve_chain	chain_id を指定して、一時停止中の手動スキルを承認、スキップ、または中止します

run_agent のパラメーター：

パラメーター	必須	説明
file	✅	agent.yaml の絶対パス
params	❌	エージェント内の {{key}} に代入するキーと値のペア
input	❌	エージェントに渡す任意の初期メッセージ

approve_chain のパラメーター：

パラメーター	必須	説明
chain_id	✅	run_agent のレスポンスにある pending_skill_chain.chain_id の値
approved	❌	スキルを実行する場合は true（デフォルト）、スキップして続行する場合は false
abort	❌	パイプライン全体を直ちに停止する場合は true

OE MCP はまずエージェントのディレクトリ内で oe-config.json を探し、見つからない場合は oe-mcp.json を使用します。

エージェントスキルの承認フロー

エージェントのスキルパイプラインに手動スキルが含まれる場合、Claude は承認ループを自動的に処理します。

1. Claude が run_agent を呼び出す → レスポンスに chain_id と skill_name を含む ⏸ Skill awaiting approval が表示されます
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 モード — サーバーを起動し、Cursor／Windsurf／Claude Desktop に URL を追加します：

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 の一部

⚡ エージェントランタイム	open-enthrium-ai-agent-runtime — SKILL.md エージェントを CLI または HTTP サーバーとして実行します
🖥️ プラットフォーム	open-enthrium-ai-platform — ワークスペース、RAG、Agent Builder を備えたフル機能のウェブアプリ
🌐 ウェブサイト	openenthrium.com

---

コントリビューション

→ サンプル設定やコネクターアダプターの追加方法については、CONTRIBUTING.md をご覧ください。

---

ライセンス

Apache-2.0 — 商用利用を含め、あらゆる目的で自由に使用、変更、デプロイできます。 使用制限はありません。テレメトリーはありません。ホームへの通信はありません。

---