ORMCP Server

Name: ORMCP Server
Author: SoftwareTree

ローカル

github.com/SoftwareTreeデータベース63 週間前に更新

リポジトリ

ORMCP Server について

ORMCP Server は、AI アプリや MCP クライアントがリレーショナルデータベースを業務オブジェクトと JSON 操作で扱うための MCP サーバーです。生の SQL やスキーマを直接公開せず、JDBC と Gilhari、宣言型 ORM マッピングを利用し、読み取り専用にも設定できます。

主な機能

01JDBC 対応リレーショナルデータベース
02JSON オブジェクトとリレーショナルデータの ORM マッピング
03複雑なオブジェクト関係とクエリ
04読み取り専用モードの選択
05宣言型 ORM 仕様

活用シーン

01業務オブジェクトを介したデータベース検索
02AI アプリへの対象範囲を絞ったデータ公開
03読み取り専用モードでのデータ検索

MCP 対応

MCP クライアントにオブジェクト指向のデータ操作ツールを提供し、Gilhari マイクロサービスと JDBC 経由でリレーショナルデータベースに接続します。データ変更ツールは設定で有効化でき、既定の読み取り専用モードでは利用できません。

#database #orm #object-relational-mapping #ai-agent #enterprise #jdbc #postgresql #mysql #sqlite #oracle #sqlserver

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

インストール方法は未掲載です

このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。

リポジトリ

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

ORMCP Server - Beta

最終更新日：2026-10-06（ORMCP 0.7.1）

AI アプリケーションをリレーショナルデータベースに接続するための Model Context Protocol（MCP）サーバー

ORMCP Server を使用すると、AI LLM と MCP クライアントは、MCP 標準プロトコルを使用して、オブジェクト指向データ（JSON 形式）をあらゆるリレーショナルデータベースと簡単にやり取りできます。

ORMCP Server は、リレーショナルデータを AI 対応にします。

⚠️ ベータ版に関するお知らせ

ORMCP Server は現在ベータ版です。ソフトウェアを試し、フィードバックを提供し、製品が最高水準の品質を満たすよう支援してくださるユーザーに、早期アクセスを提供しています。このベータ版は商用利用を目的としておらず、テスト目的のみで提供されています。

📋 目次

MCP とは？
機能
仕組み
クイックスタート
プラットフォーム別ガイド — 🍎 macOS · 🪟 Windows · 🐧 Linux
インストール
Gilhari マイクロサービスのセットアップ
設定
サーバーの起動
クライアントの設定
使用例
MCP ツールのリファレンス
トラブルシューティング
開発
貢献
ライセンス
サポートとリソース

MCP とは？

Model Context Protocol（MCP）は、AI モデルが外部のツールやデータソースとやり取りするための統一された方法を提供するオープンスタンダードです。通信を標準化することで、ユースケースごとにカスタム API 統合を構築することなく、複雑なワークフローに LLM を簡単に統合できます。

詳しくは公式 MCP ウェブサイトをご覧ください。

✨ 機能

✅ 標準化されたインターフェース： Model Context Protocol（MCP）の仕様に完全準拠
🌐 データベースを選ばない設計： JDBC 準拠のあらゆるデータベース（PostgreSQL、MySQL、Oracle、SQL Server、DB2、SQLite など）で動作
↔️ 双方向のデータフロー： AI ↔ データベース間のシームレスな通信。READONLY 操作のみをサポートするオプションも利用可能
🔄 オブジェクト・リレーショナル・マッピング（ORM）： JSON オブジェクトの操作（CRUD）をリレーショナルデータに透過的にマッピング
🔒 安全なデータアクセス： ドメインモデルに固有の操作により、データ保護を促進
🧾 宣言的な ORM 仕様： シンプルな文法に基づく、直感的で非侵襲的かつ柔軟な ORM 仕様
🕸️ 複雑なオブジェクトモデリングに対応： 1 対 1、1 対多、多対多のリレーションシップやパス式に対応
🖇️ 柔軟なクエリ： ディープクエリとシャロークエリ、および GraphQL と同様の各種操作ディレクティブにより、返されるオブジェクトの形状と範囲を調整
🚀 高度に最適化された軽量マッピングエンジン： コネクションプーリング、プリペアードステートメント、最適化された SQL ステートメント、最小限のデータベースアクセス、メタデータのキャッシュ
🔌 既存のデータとデータベースに対応： あらゆるデータベースの既存スキーマとデータで動作し、ネイティブの JSON データ型は不要
📚 充実したドキュメント： 詳細なユーザーマニュアルと README ファイル、API ドキュメント、サンプルアプリ
☁️ クラウドを選ばない設計： Docker に対応し、あらゆる環境にデプロイ可能
⚡ 高パフォーマンス： 多用途な Gilhari マイクロサービスアーキテクチャと最適化された ORM エンジンを採用
🛡️ 堅牢なエラー処理： 明確なエラーメッセージと復旧メカニズム
📈 スケーラブル： 複数の同時リクエストを効率的に処理し、Docker のスケーラブルなデプロイに対応

仕組み

+---------------------+         +----------------------+         +-------------------------+
| AI App / LLM Client | <--->   |     ORMCP Server     | <--->   |   Relational Database   |
| (MCP-compliant tool)|         |    (MCP + Gilhari)   |         | (Postgres, MySQL, etc.) |
+---------------------+         +----------------------+         +-------------------------+
         |                                |                                 |
         |  JSON (via MCP Tools)          |                                 |
         |------------------------------->|                                 |
         |                                |   ORM + JDBC                    |
         |                                |-------------------------------->|
         |                                |                                 |
         |     JSON result (MCP format)   |                                 |
         |<-------------------------------|                                 |

重要： AI アプリケーション（LLM クライアント）が自然言語を MCP ツール呼び出しに変換します。ORMCP Server は、これらの MCP ツール呼び出しを Gilhari への REST API 呼び出しに変換します。

ORMCP Server は、以下を通じて最新の AI アプリケーションとリレーショナルデータベースの橋渡しをします。

MCP Protocol：AI とツール間の標準化された通信
Gilhari：ORM と JDBC を介したリレーショナルデータベースとの統合レイヤー
JSON Mapping：透過的なオブジェクトリレーショナルマッピング

🚀 クイックスタート

ORMCP を初めてお使いですか？スムーズにセットアップできる、プラットフォーム別ガイドをご覧ください。 🍎 macOS · 🪟 Windows · 🐧 Linux

以下のセクションでは、すべてのプラットフォームを対象に、完全なリファレンスとして手順を説明します。

ORMCP を使うための簡単な 3 ステップ

1. データの範囲を定める

対象データの軽量なオブジェクトモデルを定義します
シンプルな（JDX）文法を使い、テキストファイルにそれらのモデルの宣言的な ORM 仕様を記述します

2. Gilhari マイクロサービスをビルドする

モデル、ORM 仕様、JDBC ドライバーを Dockerfile に追加します
Gilhari の Docker イメージをビルドします

3. ORMCP を使って実行する

ORMCP を Gilhari マイクロサービスに接続します
Gilhari を起動してから、ORMCP を起動します
AI エージェントまたは MCP クライアントを使い、対象のリレーショナルデータを直感的なオブジェクト指向の方法で操作します

クイックスタートの詳細

前提条件

Python 3.12+
Docker（Gilhari マイクロサービス用）
対象データベース用の JDBC ドライバー

1. ORMCP Server をインストールする

OS ごとの手順に沿ってインストールできる、プラットフォーム別ガイド： macOS · Windows · Linux

ORMCP Server は公開 PyPI で入手できます。インストールにアカウント、トークン、ベータ版へのアクセス申請は必要ありません。

pip install ormcp-server

# Verify installation
pip show ormcp-server

📌 Linux/Mac ユーザー向け： 最新の Linux ディストリビューションと macOS では、仮想環境が必要な場合があります。「externally-managed-environment」エラーが発生した場合は、プラットフォームガイドまたはトラブルシューティングガイドをご覧ください。

# Create virtual environment (recommended on Linux/Mac)
python3 -m venv .venv

# Activate — Linux/Mac:
source .venv/bin/activate
# Activate — Windows (Command Prompt):
.venv\Scripts\activate
# Activate — Windows (PowerShell):
.venv\Scripts\Activate.ps1

# Install
pip install ormcp-server

以前のベータ版インストールで Gemfury トークンをお持ちの場合、そのトークンは利用できなくなりました。Gemfury へのアクセスは終了しています。公開 PyPI から直接インストールする pip install ormcp-server を使用してください。

インストール後に ormcp-server コマンドが見つからない場合：

Python の実行ファイルのディレクトリを PATH に追加してください。詳しくはプラットフォームガイドをご覧ください。 macOS · Windows · Linux

2. Gilhari マイクロサービスをセットアップする

詳しいセットアップ方法については、以下の「Gilhari マイクロサービスのセットアップ」セクションをご覧ください。

注：完全に動作するサンプルを別のリポジトリで公開しています：gilhari_example1

サンプルを実行するには：

重要： Gilhari マイクロサービスのビルドと実行には Docker が必要です。マシンにまだインストールされていない場合は、**Docker を入手**してください。

# Clone the example repository of a sample Gilhari microservice that deals with User type of objects
git clone https://github.com/SoftwareTree/gilhari_example1.git
cd gilhari_example1

# Pull Gilhari Docker image
docker pull softwaretree/gilhari:latest

# Build a Docker image for the sample Gilhari microservice
gilhari\build.cmd    # On Windows
# or
./gilhari/build.sh   # On Linux/Mac

# Run the sample microservice
docker run -p 80:8081 gilhari_example1:1.0

# Optionally, populate the database with sample data
gilhari\curlCommandsPopulate.cmd    # On Windows
# or
./gilhari/curlCommandsPopulate.sh   # On Linux/Mac

3. 環境を設定する

# Linux/Mac
export GILHARI_BASE_URL="http://localhost:80/gilhari/v1/"
export MCP_SERVER_NAME="MyORMCPServer"

# Windows (Command Prompt)
set GILHARI_BASE_URL=http://localhost:80/gilhari/v1/
set MCP_SERVER_NAME=MyORMCPServer

# Windows (PowerShell)
$env:GILHARI_BASE_URL="http://localhost:80/gilhari/v1/"
$env:MCP_SERVER_NAME="MyORMCPServer"

4. ORMCP Server を起動する

ormcp-server

コマンドが見つからないというエラーが発生した場合は、プラットフォームガイドをご覧ください。 macOS · Windows · Linux

# Or use Python directly (works on all platforms)
python -m ormcp_server

5. AI クライアントを接続する

Claude Desktop の場合は、claude_desktop_config.json に追加します。

オプション 1：コマンド名を使用する場合（PATH の設定が必要です）：

{
  "mcpServers": {
    "my-ormcp-server": {
      "command": "ormcp-server",
      "args": [],
      "env": {
        "GILHARI_BASE_URL": "http://localhost:80/gilhari/v1/",
        "MCP_SERVER_NAME": "MyORMCPServer"
      }
    }
  }
}

オプション 2：フルパスを使用する場合（Windows ではこちらを推奨します）：

{
  "mcpServers": {
    "my-ormcp-server": {
      "command": "C:\\Users\\<YourUsername>\\AppData\\Roaming\\Python\\Python313\\Scripts\\ormcp-server.exe",
      "args": [],
      "env": {
        "GILHARI_BASE_URL": "http://localhost:80/gilhari/v1/",
        "MCP_SERVER_NAME": "MyORMCPServer"
      }
    }
  }
}

正確なパスを確認するには：

# Windows (PowerShell)
(Get-Command ormcp-server).Source

# Or use pip
pip show -f ormcp-server | findstr "Location"

# Linux/Mac
which ormcp-server

これで準備完了です。AI クライアントから自然言語を使ってデータベースを操作できるようになります。

注：クライアントとして Claude Desktop を使用する場合、手順 3（環境の設定）と 4（ORMCP サーバーの起動）は不要です。Claude Desktop が、設定済みの ORMCP サーバーを STDIO モードで自動的に起動するためです。

使用例

データをクエリする

AI プロンプト： 「年齢が 55 歳以上のユーザーをすべて表示して」

生成される MCP 呼び出し：

{
  "name": "query",
  "arguments": {
    "className": "User",
    "filter": "age >= 55",
    "maxObjects": -1,
    "deep": true
  }
}

結果：

[
  {"id": 55, "name": "Mary55", "city": "Campbell", "state": "CA"},
  {"id": 56, "name": "Mike56", "city": "Boston", "state": "MA"}
]

データを挿入する

注： insert（ほかのデータ変更ツールと同様）は、READONLY_MODE=False が設定されている場合にのみ公開されます。ORMCP サーバーの設定を参照してください。デフォルトの READONLY_MODE=True では、この例の MCP 呼び出しはクライアントから利用できません。

AI プロンプト： 「ボストン（MA）在住で 65 歳の John Smith という名前の新しいユーザー（id = 65）を追加して」

生成される MCP 呼び出し：

{
  "name": "insert",
  "arguments": {
    "className": "User",
    "jsonObjects": [
      {
        "id": 65,
        "name": "John Smith",
        "city": "Boston",
        "state": "MA",
        "age": 65
      }
    ]
  }
}

データを集計する

AI プロンプト： 「カリフォルニア州のユーザーの平均年齢は？」

生成される MCP 呼び出し：

{
  "name": "getAggregate",
  "arguments": {
    "className": "User",
    "attributeName": "age",
    "aggregateType": "AVG",
    "filter": "state='CA'"
  }
}

結果：

Gilhari マイクロサービスのセットアップ

ORMCP サーバー は、データベースとの JSON データ統合を実現するマイクロサービスフレームワークである Gilhari ソフトウェア に依存しています。ORMCP サーバーを起動する前に、このセットアップを完了する必要があります。

Gilhari ソフトウェアをインストールする

Gilhari の Docker イメージを取得します：
```
docker pull softwaretree/gilhari:latest
```
Gilhari SDK をインストールします：
- Gilhari ソフトウェアの SDK は、ORMCP サーバーパッケージの Gilhari_SDK フォルダーに同梱されています
- または、こちらからダウンロードしてください：https://www.softwaretree.com/v1/products/gilhari/download-gilhari.php
- SDK には、Gilhari ソフトウェアを簡単に使うためのドキュメント（README、API ガイド、サンプルアプリケーション）が含まれています

アプリ固有の Gilhari マイクロサービスを設定する

Gilhari SDK のドキュメントに記載されている以下の手順に従います。

ドメインモデルクラスを定義する - JSON オブジェクト用の Java コンテナークラス
宣言型 ORM 仕様を作成する - JSON 属性をデータベーススキーマにマッピングします
アプリ固有の Gilhari マイクロサービスの Docker イメージをビルドする - ドメインクラス、ORM 仕様、JDBC ドライバーを含めます

マイクロサービスを実行する：

docker run -p 80:8081 your-gilhari-service:1.0

注：動作する完全なサンプルは、別のリポジトリにあります：gilhari_example1。このサンプルでは、User オブジェクトを管理する Gilhari マイクロサービスを紹介しています。

サンプルを使ったクイックスタート：

# Clone the example repository
git clone https://github.com/SoftwareTree/gilhari_example1.git
cd gilhari_example1

# Build a Docker image for the sample Gilhari microservice
gilhari\build.cmd    # On Windows
# or
./gilhari/build.sh   # On Linux/Mac

# Run the sample microservice
docker run -p 80:8081 gilhari_example1:1.0

# Optionally, populate the database with sample data
gilhari\curlCommandsPopulate.cmd    # On Windows
# or
./gilhari/curlCommandsPopulate.sh   # On Linux/Mac

詳細なセットアップと設定方法については、gilhari_example1 の READMEを参照してください。

ORMCP パッケージのインストール

推奨：仮想環境

# Create and activate virtual environment
python -m venv .venv

# Activate the environment
# Linux/Mac:
source .venv/bin/activate
# Windows (Command Prompt):
.venv\Scripts\activate
# Windows (PowerShell):
.venv\Scripts\Activate.ps1

# Install ORMCP Server from public PyPI — no token needed
pip install ormcp-server

グローバルインストール

pip install ormcp-server

注：仮想環境を使用せずにグローバルインストールすると、ormcp-server 実行ファイルはユーザーの Python Scripts ディレクトリにインストールされます。「command not found」エラーが発生した場合は、プラットフォームガイドを参照してください。

SDK とサンプルを含む完全なパッケージへのアクセス

Gilhari SDK、サンプル、ドキュメントを含む完全なパッケージにアクセスするには：

# Download source distribution
pip download --no-binary :all: ormcp-server

# Extract it (use the appropriate version number)
tar -xzf ormcp_server-*.tar.gz
cd ormcp_server-*/

# Now you have access to:
# - Gilhari_SDK/          (Complete SDK with documentation)
# - gilhari_example1/     (Ready-to-use example microservice)
# - package/client/       (Example client code)
# - package/docs/         (Additional documentation)

Windows ユーザー： tar がインストールされていない場合は、次の方法を利用できます。

7-Zip または WinRAR を使って .tar.gz ファイルを展開します
または、PowerShell を使います：tar -xzf ormcp_server-*.tar.gz
または、PyPI プロジェクトページから直接ダウンロードします

パッケージの内容

ORMCP サーバーパッケージには、Python コード以外にも追加のリソースが含まれています。

ランタイムのインストール（Wheel）

pip でインストールすると、ORMCP Server の実行に必要なコア Python パッケージを取得できます。

pip install ormcp-server

これにより、Python 環境には必須のランタイムファイルのみがインストールされます。

SDK とドキュメントを含む完全なパッケージ（ソースディストリビューション）

完全なパッケージには、次のものが含まれます。

Gilhari_SDK/ - カスタム Gilhari マイクロサービスを作成するためのドキュメント、サンプル、ツールを含む完全な SDK
gilhari_example1/ - すぐに使えるサンプルの Gilhari マイクロサービス
package/client/ - サンプルのクライアントコードと使用方法のドキュメント
package/docs/ - 追加の技術ドキュメント
pyproject.toml - ビルド設定
README.md - このファイル
LICENSE - ライセンス条項

完全なパッケージへのアクセス

オプション 1：PyPI からダウンロード

# Download the source distribution (.tar.gz)
pip download --no-binary :all: ormcp-server

# Extract it (use the appropriate version number; e.g., 0.7.x)
tar -xzf ormcp_server-0.7.x.tar.gz
cd ormcp_server-0.7.x

# Now you have access to:
# - Gilhari_SDK/
# - gilhari_example1/
# - package/client/
# - package/docs/

Windows ユーザー： tar がインストールされていない場合は、次の方法を利用できます。

7-Zip または WinRAR を使用して、.tar.gz ファイルを展開します
または PowerShell を使用します：tar -xzf ormcp_server-0.7.x.tar.gz
または PyPI プロジェクトページから直接ダウンロードします

オプション 2：パッケージページからダウンロード

https://pypi.org/project/ormcp-server/ にアクセスし、.tar.gz ファイルをダウンロードしてください。

「Download files」セクションを探し、ソースディストリビューション（.tar.gz）をダウンロードしてください。

Gilhari SDK の使用

ソースディストリビューションを展開した後、次の操作を行います。

# Navigate to the SDK
cd Gilhari_SDK

# Read the documentation
# - Check README files for setup instructions
# - Review examples in the examples/ directory
# - See API documentation for ORM specification details

# The SDK includes:
# - Gilhari Docker base image information
# - Documentation (READMEs, API guides)
# - Sample applications
# - Tools for reverse-engineering ORM from existing databases
# - JDX grammar specification

サンプルの Gilhari マイクロサービスの実行

# Navigate to the example
cd gilhari_example1

# Follow the README.md in that directory to:
# 1. Build the Docker image
# 2. Run the microservice
# 3. Populate sample data
# 4. Test with ORMCP Server

2 種類のパッケージ形式がある理由

Wheel (.whl) - バイナリディストリビューションです。インストールが速く、ランタイムコードのみが含まれます（約 50KB）。
ソースディストリビューション (.tar.gz) - すべてのリソースを含む完全なパッケージです（数 MB 程度）。

ほとんどのユーザーは、ORMCP Server の実行には Wheel だけで十分です。次のものが必要な場合は、ソースディストリビューションをダウンロードしてください。

カスタムマイクロサービスを作成するための Gilhari SDK
サンプルアプリケーションとクライアントコード
完全なドキュメント
追加の技術ガイド

ORMCP サーバーの設定

環境変数で設定します。

変数	説明	デフォルト	例
`GILHARI_BASE_URL`	Gilhari マイクロサービスの URL	`http://localhost:80/gilhari/v1/`	`http://myhost:8888/gilhari/v1/`
`MCP_SERVER_NAME`	サーバー識別子	`ORMCPServerDemo`	`MyCompanyORMCP`
`GILHARI_TIMEOUT`	API タイムアウト（秒）	`30`	`60`
`LOG_LEVEL`	ログの詳細度	`INFO`	`DEBUG`, `WARNING`, `ERROR`
`ORMCP_LOG_FILE`	コンソールに加えて出力するログファイル。コンソールのみにする場合は `none`（または `off`）	システムの一時ディレクトリ内の `ormcp_server_debug.log`	`C:\Logs\ormcp.log`, `none`
`READONLY_MODE`	読み取り操作のみを公開	`True`	`False`
`GILHARI_NAME`	アプリ固有の Gilhari マイクロサービス名	`my-gilhari-microservice`	`sakila-service`
`GILHARI_IMAGE`	アプリ固有の Gilhari マイクロサービスの Docker イメージ名	""	`gilhari_example1:1.0`
`GILHARI_HOST`	起動時の可用性チェックに使用するホスト。`GILHARI_BASE_URL` のホストと異なる場合に指定します（通常は不要）	`GILHARI_BASE_URL` 内のホスト	`10.20.30.40`
`GILHARI_PORT`	起動時の可用性チェック（および ORMCP が起動するコンテナー）に使用するポート。`GILHARI_BASE_URL` のポートと異なる場合に指定します（通常は不要）	`GILHARI_BASE_URL` 内のポート	`8888`
`HOST_ORIGIN_PROTECTION`	HTTP モード：信頼されていない `Host`／`Origin` ヘッダーを含むリクエストを拒否します（DNS リバインディング対策）	`true`	`false`
`ALLOWED_HOSTS`	HTTP モード：デフォルトに加えて信頼するホスト名をカンマ区切りで指定します	なし	`host.docker.internal,ormcp.internal`
`ALLOWED_ORIGINS`	HTTP モード：信頼するオリジンをカンマ区切りで指定します	なし	`https://app.example.com`

注：

READONLY_MODE のデフォルトは True です。データを変更する可能性のある MCP ツール（insert、update、update2、delete、delete2）は、READONLY_MODE=False を明示的に設定しない限り、ORMCP サーバーから MCP クライアントに公開されません。
起動時に ORMCP は、GILHARI_BASE_URL にある Gilhari マイクロサービスが応答するか確認します。ORMCP は以降のすべてのリクエストも同じアドレスに送信します。ORMCP 0.7.0 以降、この確認に使うホストとポートは GILHARI_BASE_URL から取得されるため、GILHARI_BASE_URL だけで十分です。GILHARI_HOST と GILHARI_PORT はその値を上書きする場合にのみ使用し、GILHARI_BASE_URL と異なる場合は ORMCP が警告します。
マイクロサービスが応答しない場合、ORMCP は自身で起動できます。GILHARI_IMAGE（必要に応じて GILHARI_NAME も）を設定してください。コンテナーのホストポートには、GILHARI_BASE_URL（または GILHARI_PORT）のポートが使われます。それでも確認に失敗すると、ORMCP は確認したアドレスと次に行うべきことを示すメッセージを出して停止します。
ORMCP_LOG_FILE：ファイルは 5 MB でローテーションされ、古いコピーが 2 つ保持されます。書き込みに失敗した場合、ORMCP は警告をログに記録し、コンソールへのログ出力を続けます。Windows シェルでは、set ORMCP_LOG_FILE= を実行すると変数が削除され（デフォルトのファイルが使われます）。ファイルへのログ出力を無効にするには none を使用します。
HOST_ORIGIN_PROTECTION では true／1／yes／on／strict および false／0／no／off を指定できます。auto を含む、それ以外の値を指定すると、保護は有効のままとなり、警告が記録されます。ALLOWED_HOSTS／ALLOWED_ORIGINS が適用されるのは、保護が有効な場合のみです。

設定例

# Linux/Mac
export GILHARI_BASE_URL="http://localhost:80/gilhari/v1/"
export GILHARI_TIMEOUT="30"
export MCP_SERVER_NAME="MyORMCPServer"
export LOG_LEVEL="INFO"

# Windows (Command Prompt)
set GILHARI_BASE_URL=http://localhost:80/gilhari/v1/
set GILHARI_TIMEOUT=30
set MCP_SERVER_NAME=MyORMCPServer
set LOG_LEVEL=INFO

# Windows (PowerShell)
$env:GILHARI_BASE_URL="http://localhost:80/gilhari/v1/"
$env:GILHARI_TIMEOUT="30"
$env:MCP_SERVER_NAME="MyORMCPServer"
$env:LOG_LEVEL="INFO"

サーバーの起動

標準モード（推奨）

（使用している場合は）仮想環境を有効にします。

# Linux/Mac
source .venv/bin/activate

# Windows (Command Prompt)
.venv\Scripts\activate

# Windows (PowerShell)
.venv\Scripts\Activate.ps1

CLI コマンドを使ってサーバーを起動します。

ormcp-server

これにより、main.py エントリーポイントを介して、MCP サーバーが stdio モードで実行されます。

トラブルシューティング — コマンドが見つからない場合：

'ormcp-server' is not recognized または command not found と表示される場合は、PATH の設定方法と修正方法について、使用しているプラットフォームのガイドを参照してください。 macOS · Windows · Linux

# Use Python directly on any platform (always works)
python -m ormcp_server

ソースコードを直接使用する（上級者向け）

注記： ソース配布物が必要です。次のコマンドでダウンロードします。

pip download --no-binary :all: ormcp-server
tar -xzf ormcp_server-*.tar.gz
cd ormcp_server-*/

Python でサーバーを直接実行します。

python src/ormcp_server.py

これにより CLI ラッパーを介さず、サーバーを直接実行できます。

別の方法（上級者向け）

実行可能ファイルを直接実行する場合：

# Windows
.venv\Scripts\ormcp-server.exe

# Linux/Mac
.venv/bin/ormcp-server

fastmcp CLI を使用する場合（ソース配布物が必要）：

fastmcp run src/ormcp_server.py

MCP Inspector の開発モードを使用する場合（ソース配布物が必要）：

mcp dev src/ormcp_server.py

ソースコードを使用せずに MCP Inspector を使用する場合：

ormcp-server パッケージがインストールされている場合は、MCP Inspector を使用してサーバーの機能を確認できます。

# Using the installed package
npx @modelcontextprotocol/inspector python -m ormcp_server

# Or if you have the command in PATH
npx @modelcontextprotocol/inspector ormcp-server

これにより、ソース配布物がなくても、ORMCP Server のツールを対話形式でテストして確認できます。

HTTP または SSE トランスポートのサポート

注記： ORMCP のデフォルトは stdio トランスポートです。これは、ほとんどのデスクトップ AI クライアント（例：Claude Desktop）でそのまま使用されます。HTTP モード（ストリーミング HTTP トランスポート）も、単体またはネットワーク経由でのデプロイメントで完全にサポートされています。詳細はHTTP モードの操作ガイドを参照してください。一部のクライアント（例：Gemini CLI）では、現在 HTTP モードが必要です。

コマンドラインから ORMCP サーバーを HTTP モードで起動できます。

# Basic HTTP mode
python src/ormcp_server.py --transport http

# Or using the CLI
ormcp-server --transport http

ホストとポートをカスタマイズする場合：

python src/ormcp_server.py --transport http --host 0.0.0.0 --port 9000

# Or using CLI
ormcp-server --transport http --host 0.0.0.0 --port 9000

使用可能なコマンドラインオプション：

--transport：「stdio」（デフォルト）または「http」を選択します
--host：ホストアドレスを設定します（デフォルト：127.0.0.1、HTTP モードでのみ使用）
--port：ポート番号を設定します（デフォルト：8080、HTTP モードでのみ使用）

HTTP の簡易セットアップ：

python src/ormcp_server.py --transport http
# or
ormcp-server --transport http

HTTP モードではアプリケーションの配信に uvicorn を使用するため、依存関係としてインストールされていることを確認してください。

HTTP モードでの使用

HTTP モードで実行されている MCP サーバーは、Web ブラウザーから直接アクセスするようには設計されていません。これは、ルートパスへの HTTP GET リクエストではなく、特定の MCP プロトコルメッセージを想定する API サーバーです。

まとめ

最もシンプルで推奨される方法として、ormcp-server CLI を使用します。
ソース配布物を使って簡単に実行する場合は、python src/ormcp_server.py を直接実行します。
ソース配布物を使った高度な開発・テストでは、mcp dev または fastmcp run を使用します。

想定される出力

... - microservice_ensure - INFO - Checking the Gilhari microservice at http://localhost:80/gilhari/v1/health/check
... - microservice_ensure - INFO - Health endpoint check passed for my-gilhari-microservice
... - INFO - Gilhari microservice is available
... - INFO - ORMCP server name: ORMCPServerDemo
... - INFO - GILHARI BASE URL: http://localhost:80/gilhari/v1/
🟢 This ORMCP server is configured to expose just the READONLY MCP tools
... - INFO - Log file: <temp directory>/ormcp_server_debug.log
🟢 ORMCP server v0.7.x starting in stdio (or HTTP) mode ...

GILHARI_BASE_URL で Gilhari マイクロサービスから応答がない場合、ORMCP は確認したアドレスを示すメッセージと、その後に💡「対処方法」のヒントを表示して停止します。

コンテナ化されたデプロイメント（MCP レジストリ）

Glama などの MCP レジストリを介したデプロイメント用に、このリポジトリのルートに start.sh スクリプトが用意されています。このスクリプトは、コンテナ化された環境で ORMCP Server をインストールして起動します。必要な環境変数と設定の詳細については、スクリプトを参照してください。

MCP クライアントの設定

Claude Desktop

プラットフォーム別の設定ファイルの場所とパスの設定： macOS · Windows · Linux

オプション 1：コマンド名を使用する（PATH の設定が必要）

{
  "mcpServers": {
    "my-ormcp-server": {
      "command": "ormcp-server",
      "args": [],
      "env": {
        "GILHARI_BASE_URL": "http://localhost:80/gilhari/v1/",
        "MCP_SERVER_NAME": "MyORMCPServer"
      }
    }
  }
}

オプション 2：フルパスを使用する（Windows に推奨）

{
  "mcpServers": {
    "my-ormcp-server": {
      "command": "C:\\Users\\<YourUsername>\\AppData\\Roaming\\Python\\Python313\\Scripts\\ormcp-server.exe",
      "args": [],
      "env": {
        "GILHARI_BASE_URL": "http://localhost:80/gilhari/v1/",
        "MCP_SERVER_NAME": "MyORMCPServer"
      }
    }
  }
}

正確なインストールパスを確認する方法：

# Windows (PowerShell)
(Get-Command ormcp-server).Source

# Windows (Command Prompt)
where ormcp-server

# Linux/Mac
which ormcp-server

# Any platform
pip show -f ormcp-server | grep "ormcp-server.exe"  # Windows
pip show -f ormcp-server | grep "ormcp-server$"     # Linux/Mac

オプション 3：Python を直接実行する

{
  "mcpServers": {
    "my-ormcp-server": {
      "command": "python", 
      "args": [
        "-m",
        "ormcp_server"
      ],
      "env": {
        "GILHARI_BASE_URL": "http://localhost:80/gilhari/v1/",
        "MCP_SERVER_NAME": "MyORMCPServer"
      }
    }
  }
}

オプション 4：FastMCP を使用する（ソース配布物を使う開発者向け）

{
  "mcpServers": {
    "ORMCPServerDemo": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "fastmcp",
        "run",
        "<path_to_your_ormcp-server-project>/src/ormcp_server.py"
      ],
      "env": {
        "GILHARI_BASE_URL": "http://localhost:80/gilhari/v1/",
        "MCP_SERVER_NAME": "MyORMCPServer"
      }
    }
  }
}

オプション 5：HTTP モード（カスタムコネクタ）

claude_desktop_config.json がローカルの MCP サーバーを起動できるのは stdio のみです（オプション 1～4）。--transport http を指定して起動したサーバーは接続できません。Claude Desktop から MCP サーバーに HTTP 経由で接続するには、カスタムコネクタを使用します。

ORMCP を HTTP モードで起動します：ormcp-server --transport http --port 8080
OpenAI GPTs の説明と同様に、cloudflared または ngrok などを使って、パブリックな HTTPS URL からアクセスできるようにします。カスタムコネクタはお使いのコンピューターからではなく、Anthropic のクラウドから接続されるため、localhost の URL は使用できません。
トンネルのホスト名を許可します。許可しない場合、ORMCP の Host/Origin 保護機能によってリクエストが拒否されます（HTTP 421）：例：ALLOWED_HOSTS=<your-tunnel-host>
Claude Desktop で 設定 → コネクタ → カスタムコネクタを追加 を選択し、パブリック URL の末尾に /mcp を付けて入力します。例：https://<your-tunnel-host>/mcp

カスタムコネクタはすべての Claude プランで利用できます（Free プランでは 1 つに制限されています）。Team プランと Enterprise プランでは、管理者による許可が必要な場合があります。

注：

ORMCPServerDemo は ORMCP サーバーのデフォルト名です。
<YourUsername> を実際の Windows ユーザー名に置き換えてください。
関連する Gilhari マイクロサービスのポート番号を「GILHARI_BASE_URL」環境変数で指定する場合、その Gilhari マイクロサービスがリッスンしているポートを指定してください。
Claude Desktop が HTTP モードの ORMCP サーバーに接続できるのは、パブリックな HTTPS URL を使用したカスタムコネクタとしてのみです（オプション 5）。ローカルサーバーには stdio を使用してください（オプション 1～4）。

Gemini CLI

Gemini の settings.json ファイルを更新します：

{
  "mcpServers": {
    "my-ormcp-server-http": {
      "httpUrl": "http://127.0.0.1:8080/mcp"
    }
  }
}

注：Gemini CLI では現在、HTTP モードが必要です。

OpenAI GPTs（Developer Mode）

ORMCP サーバーを開発者モードのカスタム GPT に接続するには、サーバーを HTTP モードで実行し、公開 URL からアクセスできるようにする必要があります。

バックエンドを準備する：
- まず、セットアップ手順に従って、Gilhari マイクロサービスがコンパイルされ、Docker コンテナー内で実行されていることを確認します。
- curl を使って、Gilhari サービスが応答することを確認します。
```
curl -i http://localhost:80/gilhari/v1/getObjectModelSummary/now
```
ORMCP サーバーを設定して実行する：
- ORMCP サーバーが Gilhari に接続できるように、必要な環境変数を設定します。
```
export GILHARI_BASE_URL="http://localhost:80/gilhari/v1/"
export MCP_SERVER_NAME="MyORMCPServer"
export GILHARI_TIMEOUT="30"
export LOG_LEVEL="INFO"
```
- ウェブベースのクライアントには HTTP モードが必要なため、ORMCP サーバーを HTTP モードで起動します。
```
# Run from the project's root directory
ormcp-server --transport http --port 8080
```
公開 URL を使ってサーバーを公開する： OpenAI のサーバーからローカルの ORMCP サーバーにアクセスできるように、公開ウェブアドレスが必要です。cloudflared や ngrok などのトンネリングサービスを使って、ローカルマシンに転送する安全な公開 URL を作成します。
- オプション A：cloudflared を使う（推奨）
  - 新しいターミナルで、サーバーのポートを指定して Cloudflare トンネルを開始します。
```
cloudflared tunnel --url http://localhost:8080
```
  - cloudflared から永続的な公開 URL が提供されます（例：https://<your-tunnel-name>.trycloudflare.com）。
- オプション B：ngrok を使う
  - 新しいターミナルで ngrok を起動し、ポート 8080 にトラフィックを転送します。
```
ngrok http 8080
```
  - ngrok から一時的な公開 HTTPS URL が提供されます（例：https://random-string.ngrok-free.app）。無料プランでは、ngrok を再起動するたびに URL が変わることに注意してください。
カスタム GPT に接続する：
- cloudflared または ngrok が生成した公開 URL を取得します。
- URL の末尾に /mcp を追加します。これが MCP エンドポイントとなります。例：https://<your-public-url>/mcp。
- GPT の設定（Settings → Apps & Connectors → Create）で、この完全な URL を MCP Server URL 欄に貼り付けます。GPT が ORMCP サーバーのツールを検出し、接続します。

その他の MCP クライアント

ORMCP サーバーに接続し、ORMCP サーバーが提供する MCP 対応の ORM ツールを使用します。
適切なトランスポートモード（STDIO または HTTP）を使い、クライアントの MCP サーバー設定要件に従って設定します。
📚 統合ガイド： ORMCP サーバーへの接続について詳しくは、以下のドキュメントをご覧ください。
- MCP Protocol Reference - 低レベルの JSON-RPC プロトコルの詳細
- Using the ORMCP Client Example - Python クライアントの使用ガイド
- Interacting with ORMCP Server in STDIO Mode - STDIO トランスポートのガイド
- Interacting with ORMCP Server in HTTP Mode - HTTP トランスポートのガイド
- ドキュメントリポジトリには追加のガイドもあります（ソース配布物にも含まれています）。

MCP ツールリファレンス

ORMCP Server は、データベースを操作するための以下の MCP ツールを提供します。

📖 詳細な API ドキュメント： パラメーターの仕様と技術的な詳細については、MCP Tools API Reference をご覧ください。

💡 使用例： 実際の使用例については、examples directory をご覧ください。

列名ではなく属性名： フィルター、プロジェクション、集計では、データベースの列名ではなく、オブジェクトモデルの概要（getObjectModelSummary）に記載された属性名を使用します。

一意の主キーを持たないクラス： オブジェクトモデルの概要で DB_PRIMARY_KEY_EXISTS FALSE と示されているクラスには、キー値が同じオブジェクトが複数存在する場合があります。そのクラスには、フィルターを指定して query、access、getAggregate、update2／delete2 を使用してください。getObjectById、update、delete はサポートされていません。

フィルター： query、getAggregate、update2、delete2 の filter パラメーターには、SQL の WHERE 句構文（WHERE という語を除く）で条件を指定します。条件はデータベースで評価されます。例：isactive = true AND tier IN ('Gold', 'Platinum')。query のフィルターは ORDER BY で終えることができ、COUNT(thisObject.listCustomerorder.id) > 10 のようなパス式で参照オブジェクトを調べることもできます。演算子、リテラルの形式、例については、フィルターの構文をご覧ください。

コア操作

`getObjectModelSummary`

基盤となるオブジェクトモデルの情報を取得します。

戻り値： ドメインモデル内のクラス（型）、属性、主キー、リレーションシップに関する情報です。

`query`

フィルタリングとリレーションシップのたどりを使ってオブジェクトをクエリします。

パラメーター：

className（string）：クエリ対象のオブジェクトの型
filter（string、任意）：フィルタリングに使用する SQL 形式の WHERE 句
maxObjects（integer、任意）：取得するオブジェクトの最大数（すべて取得する場合は -1、デフォルト：-1）
deep（boolean、任意）：結果に参照オブジェクトを含めます（デフォルト：true）
operationDetails（string、任意）：クエリを細かく調整するための操作指示を含む JSON 配列。次のような GraphQL 形式の操作をサポートします。
- projections：特定の属性のみを取得します
- ignore または follow：参照オブジェクトのブランチを制御します
- filters：参照オブジェクトにフィルターを適用します
クラスに DB_PRIMARY_KEY_EXISTS FALSE と指定されている場合を除き、プロジェクションにはそのクラスの主キー属性を含める必要があります。
allowDuplicates（boolean、任意）：主キー値が同じ行であっても、条件に合致する各行を個別のオブジェクトとして返します（デフォルト：false。Gilhari 0.8.7 以降が必要です）

戻り値： 条件に合致するオブジェクトの JSON 配列（該当するものがない場合は []）

`getObjectById`

主キーを指定して特定のオブジェクトを取得します。

パラメーター：

className（string）：取得するオブジェクトの型
primaryKey（object）：主キーの値（単一の値または複合キーオブジェクト）
deep（boolean、任意）：参照オブジェクトを含めます（デフォルト：true）
operationDetails（string、任意）：クエリを細かく調整するための操作指示

戻り値： オブジェクトを単一の JSON オブジェクトとして返します。該当する ID のオブジェクトがない場合は null を返します。

`access`

参照元オブジェクトの特定の属性が参照するオブジェクトを取得します。

パラメーター：

className（string）：参照元オブジェクトの型
jsonObject（object）：参照を含む参照元オブジェクト
attributeName（string）：値を取得する参照属性の名前
deep（boolean、任意）：取得したオブジェクトが参照するオブジェクトも含めます（デフォルト：true）
operationDetails（string、任意）：クエリを細かく調整するための操作指示

戻り値： コレクション属性の場合は、参照オブジェクトの JSON 配列（該当するものがない場合は []）、それ以外の場合は参照オブジェクトを返します。

`getAggregate`

オブジェクト全体の集計値（COUNT、SUM、AVG、MIN、MAX）を計算します。

パラメーター：

className（string）：集計対象のオブジェクトの型
attributeName（string）：集計対象の属性
aggregateType（string）：集計の種類 - COUNT、SUM、AVG、MIN、MAX
filter（string、省略可）：集計前にオブジェクトを絞り込む SQL 風の WHERE 句

戻り値： オブジェクトのリストではなく、単一の JSON 値（例：COUNT の場合は 1000）

`get_server_version`

ORMCP Server のバージョンを取得します。

戻り値： version、description、gilhari_base_url（このサーバーが使用する Gilhari マイクロサービス。0.7.1 で追加）を含む JSON オブジェクト

データ変更操作

注記： これらのツールは、READONLY_MODE=False が設定されている場合にのみ公開されます。READONLY_MODE のデフォルトは True のため、insert、update、update2、delete、delete2 は初期状態では利用できません。上記のORMCP Server の設定を参照してください。

`insert`

1 つ以上の JSON オブジェクトをデータベースに保存します。

パラメーター：

className（string）：挿入するオブジェクトの型
jsonObjects（array）：データベースに保存する JSON オブジェクトのリスト
deep（boolean、省略可）：参照先のオブジェクトも保存します（デフォルト：true）

戻り値： 操作が成功すると、短い確認メッセージ（プレーンテキスト。JSON ではありません）が返されます。失敗した場合はエラーが報告されます。

`update`

1 つ以上の既存オブジェクトを新しい値で更新します。update は、指定されたオブジェクト（主キーで照合）で保存済みのオブジェクトを置き換えるため、すべての属性を含めてください。一部の属性のみを変更するには、主キーで絞り込んで update2 を使用します。

パラメーター：

className（string）：更新するオブジェクトの型
jsonObjects（array）：更新後の値を含む完全なオブジェクトのリスト（それぞれに主キーとその他すべての属性を含めます）
deep（boolean、省略可）：参照先のオブジェクトも更新します（デフォルト：true）

`update2`

フィルター条件に一致するオブジェクトを一括更新します。

パラメーター：

className（string）：更新するオブジェクトの型
filter（string）：更新対象のオブジェクトを特定する SQL 風の WHERE 句
newValues（array）：属性名と新しい値を交互に並べたリスト。例：["status", "active", "age", 40]
deep（boolean、省略可）：参照先のオブジェクトも更新します（デフォルト：true）

戻り値： 更新されたトップレベルのオブジェクト数

`delete`

データベースから特定のオブジェクトを削除します。

パラメーター：

className（string）：削除するオブジェクトの型
jsonObjects（array）：削除するオブジェクト（識別には主キーが必要です）
deep（boolean、省略可）：参照先のオブジェクトも削除します（デフォルト：true）

`delete2`

フィルター条件に一致するオブジェクトを一括削除します。

パラメーター：

className（string）：削除するオブジェクトの型
filter（string、省略可）：削除対象のオブジェクトを特定する SQL 風の WHERE 句（空文字列を指定すると、指定したクラスのすべてのオブジェクトが削除されます）
deep（boolean、省略可）：参照先のオブジェクトも削除します（デフォルト：true）

戻り値： 削除されたトップレベルのオブジェクト数

注記： READONLY_MODE のデフォルトは True のため、READONLY_MODE=False を明示的に設定しない限り、データ変更操作の MCP ツール（insert、update、update2、delete、delete2）は MCP クライアントに公開されません。

トラブルシューティング

よくある問題と解決策については、トラブルシューティング完全ガイドを参照してください。

簡単なトラブルシューティング

インストール時の問題：

コマンドが見つからない → PATH の設定については、お使いのプラットフォームガイドをご覧ください：macOS · Windows · Linux
外部管理の環境 → 仮想環境を使用してください（トラブルシューティングガイドをご覧ください）
実行ファイルが空 → パッケージを再インストールしてください
依存関係が不足している → pip install --force-reinstall ormcp-server
v0.6.2 以前からアップグレードした後に fastmcp の ImportError が発生する → アップグレード後の fastmcp インポートエラーをご覧ください

Gilhari の使用時の問題：

シェルスクリプトの実行権限が拒否される → chmod +x scripts/*.sh gilhari/*.sh を実行するか、sh gilhari/build.sh を使用してください（Linux/Mac）
データベース接続エラー → Gilhari の JDBC ドライバーを確認してください

実行時の問題：

サーバーが起動しない → Gilhari が実行中であること、および GILHARI_BASE_URL にポートが指定されていることを確認してください（docker ps にはコンテナーのホストポートが表示されます。たとえば、0.0.0.0:8130->8081/tcp の場合は 8130 です）。エラーメッセージには ORMCP が確認したアドレスが記載されています
実行の詳細 → ログファイルを確認してください（システムの一時ディレクトリにある ormcp_server_debug.log、または ORMCP_LOG_FILE）
データベース接続エラー → Gilhari の JDBC ドライバーを確認してください
MCP クライアントの接続に関する問題 → 設定ファイルの構文を確認してください

デバッグモードを有効にする：

# Linux/Mac
export LOG_LEVEL=DEBUG
ormcp-server

# Windows (Command Prompt)
set LOG_LEVEL=DEBUG
ormcp-server

# Windows (PowerShell)
$env:LOG_LEVEL="DEBUG"
ormcp-server

サポートを受ける：

ドキュメント：github.com/softwaretree/ormcp-docs
問題：github.com/softwaretree/ormcp-docs/issues
メール：[email protected]

開発

テスト

ソース配布物を使用したテストと開発について：

# Download source distribution
pip download --no-binary :all: ormcp-server
tar -xzf ormcp_server-*.tar.gz
cd ormcp_server-*/

# Install in development mode
pip install -e ".[dev]"

# Run tests
pytest

Gilhari マイクロサービスの開発

ORMCP Server は、データベースとの JSON データ統合のための RESTful マイクロサービスフレームワークである Gilhari ソフトウェアを活用します。
まず、アプリケーションのオブジェクトリレーショナルデータモデルに基づいて、カスタム Gilhari マイクロサービスを作成します。
オブジェクトリレーショナルマッピング（ORM）仕様では、リレーショナルモデルに対応するオブジェクトモデルの範囲と構造を定義し、制御します。
ORM 仕様は、シンプルな文法に基づくテキストファイル（.jdx）で宣言的に定義します。
Gilhari SDK に付属するツールやサンプルを使って、既存のデータベーススキーマから ORM 仕様をリバースエンジニアリングできる場合があります。examples\JDX_ReverseEngineeringJSONExample ディレクトリをご確認ください。
リバースエンジニアリングのサンプルは、github.com/SoftwareTree/JDX_ReverseEngineeringJSONExample からも入手できます。
カスタム Gilhari マイクロサービスの作成方法については、ソース配布パッケージに含まれる Gilhari SDK のドキュメントをご覧ください。
設定されていれば、ORMCP サーバーは環境変数 GILHARI_IMAGE、GILHARI_NAME、GILHARI_PORT を使用して Gilhari マイクロサービスを起動できますが、ORMCP サーバーを使用する前にカスタム Gilhari マイクロサービスを起動することをおすすめします。また、ORMCP サーバーの環境変数「GILHARI_BASE_URL」のポート番号が、カスタム Gilhari マイクロサービスが REST 呼び出しを受け付けるポート番号と一致していることを確認してください。ORMCP は起動時にそのアドレスを確認します。

貢献

ORMCP Server に関心をお寄せいただき、ありがとうございます。

🚫 現時点ではコードの貢献を受け付けていません

ORMCP Server はプロプライエタリソフトウェアです。コードの貢献、プルリクエスト、機能の提案は受け付けていません。

🐞 フィードバックとバグ報告

ベータ版へのフィードバックを歓迎します。以下を通じて、ORMCP Server の改善にご協力いただけます。

バグや問題の報告
改善の提案
ご利用体験の共有

フィードバックの提供方法

GitHub Issues：問題や提案を報告
メール：[email protected]

ご提供いただいたフィードバックは、クレジットの表示や報酬の義務を伴わず、Software Tree による製品改善に使用される場合があります。

サードパーティソフトウェア

Gilhari と JDX の依存関係： ORMCP Server の動作には Gilhari マイクロサービスが必要であり、Gilhari は基盤となる ORM テクノロジーである JDX に依存しています。どちらも Software Tree のプロプライエタリ製品です。Gilhari と JDX には、さまざまなサードパーティソフトウェアコンポーネントが組み込まれています。これらのサードパーティコンポーネントとそのライセンスの詳細については、Gilhari SDK の LICENSE ファイルをご覧いただくか、https://www.softwaretree.com/v1/products/gilhari/ および https://www.softwaretree.com/v1/products/jdx/jdx.html をご覧ください。

Python の依存関係： ORMCP Server は、各ライセンスの適用を受ける以下のオープンソース Python ライブラリを使用しています。

mcp（Model Context Protocol SDK）
fastmcp（FastMCP フレームワーク）
httpx（HTTP クライアントライブラリ）
pydantic（データ検証ライブラリ）
uvicorn（ASGI サーバー）
requests（HTTP ライブラリ）

ライセンス

ORMCP Server は Software Tree, LLC が所有するプロプライエタリソフトウェアです。利用条件の詳細については、LICENSE ファイルをご覧ください。

**ベータ評価：**ORMCP Server は現在、評価ライセンスのもとでベータ製品として提供されています。このライセンスにより、評価期間（インストール日から30日間）に限り、テストおよび評価目的で無料で使用できます。

**Gilhari と JDX の依存関係：**ORMCP Server の動作には Gilhari マイクロサービスが必要であり、Gilhari は基盤となる ORM テクノロジーである JDX に依存しています。どちらも、それぞれ独自のライセンス契約に基づく Software Tree のプロプライエタリ製品です。ORMCP Server を使用することで、Gilhari ライセンスおよび JDX ライセンスにも従うことに同意したものとみなされます。Gilhari と JDX には、さまざまなサードパーティソフトウェアコンポーネントが組み込まれています。詳細については、Gilhari SDK の LICENSE ファイルをご覧いただくか、https://www.softwaretree.com/v1/products/gilhari/ および https://www.softwaretree.com/v1/products/jdx/jdx.html をご覧ください。

**商用ライセンス：**評価期間終了後の ORMCP Server の使用には、その時点で適用される Software Tree のライセンス条件が適用されます。詳細についてのお問い合わせや関心の表明は、Software Tree（[email protected]）にご連絡いただくか、https://www.softwaretree.com をご覧ください。

サポートとリソース

ドキュメント：ドキュメントとガイドの完全版
プラットフォームガイド：macOS · Windows · Linux
実例：例を見る | 例のガイド - 実際のユースケースと統合例
マイクロサービスの例：gilhari_example1 リポジトリ
バグ報告：問題を報告
メールサポート：[email protected]
Gilhari サポート：Software Tree Gilhari ドキュメント
MCP プロトコル：MCP 公式サイト
ORMCP サーバーのインストール：pip install ormcp-server — ベータトークンは不要です。セットアップ手順の詳細は、softwaretree.com/products/ormcpをご覧ください。

AI とデータベースのコミュニティのために、心を込めて作りました ❤️

Markdown 対応

ログインしてコメント

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。