MCP Adonet Server

🚀 MCP プロトコル ADO.NET サーバー（Virtuoso用）

MCP プロトコルの ADO.NET サーバーは、Virtuoso データベースとの相互作用を可能にするサーバーです。このサーバーを使用することで、SQL および SPARQL クエリを実行し、データベースとのやり取りを行うことができます。

🚀 クイックスタート

📦 インストール

.NET SDK のインストール

MCP プロトコルの ADO.NET サーバーを実行するには、まず .NET SDK をインストールする必要があります。インストールが完了したら、コマンドラインから dotnet コマンドが使用できることを確認してください。

コードリポジトリのクローン

以下のコマンドを使用して、コードをクローンします。

git clone https://github.com/virtuoso/mcp-adonet-server.git

依存関係のインストール

プロジェクトディレクトリに移動し、必要な NuGet パッケージをインストールします。

dotnet restore

🔧 設定

データソース名 (DSN) の設定

オペレーティングシステムに応じて、以下の手順で DSN を設定します。

Windows システム

1. 「コントロールパネル」を開きます。
2. 「システムとセキュリティ」を選択し、次に「システム」を選択します。
3. 「環境変数」をクリックします。
4. 「システム変数」のセクションで、ODBCAD32 変数（Windows 7 以上）を見つけて編集します。
5. Virtuoso データソースを追加または構成します。

Linux/MacOS システム

unixODBC をインストールします。

# Debian/Ubuntu システムの場合：
sudo apt-get install -y unixodbc-dev

# MacOS システムの場合、Homebrew を使用：
brew install --cask unixodbc

DSN 構成ファイル（~/.odbcinst.ini）を作成して編集します。

[VirtuosoODBC]
Description = Virtuoso ODBC Driver
Driver      = /path/to/unixODBC/VIRT_ODBC.DLL
File        =

▶️ サーバーの実行

基本実行コマンド

プロジェクトのルートディレクトリで以下のコマンドを実行して、サーバーを起動します。

dotnet run --project MCP_AdoNet_Server.csproj

環境変数の設定

ADO_URL と API_KEY 環境変数を設定することで、データソースと API キーを指定します。

# Windows/Linux システム：
set ADO_URL="DSN=MyDSN;UID=username;PWD=password"
set API_KEY="sk-xxx-myapikey-xxx"

dotnet run --project MCP_AdoNet_Server.csproj

# MacOS システム：
export ADO_URL="DSN=MyDSN;UID=username;PWD=password"
export API_KEY="sk-xxx-myapikey-xxx"

dotnet run --project MCP_AdoNet_Server.csproj

✨ 主な機能

データベースの相互作用

• データベースのクエリ：ado_query_database、ado_query_database_md、ado_query_database_jsonl エンドポイントを介して SQL クエリを実行し、結果を取得します。
• SPARQL クエリ：ado_sparql_query エンドポイントを使用して SPARQL クエリを実行します（Virtuoso 固有の機能）。

拡張機能

• 混合クエリ：ado_spasql_query エンドポイントを利用して SQL/SPARQL 混合クエリを実行します（Virtuoso 固有の機能）。
• AI サポート：ado_virtuoso_support_ai エンドポイントを通じて Virtuoso の AI サポート機能を呼び出します。

💻 使用例

基本的なクエリ

以下のコマンドを使用して、基本的なクエリ機能をテストします。

curl "http://localhost:3000/ado_query_database?query=SELECT%20*%20FROM%20some_table"

SPARQL クエリ

SPARQL クエリを実行するには、以下のコマンドを使用します。

curl "http://localhost:3000/ado_sparql_query?sparql=SELECT%20*%20FROM%20some_rdf_graph"

🔧 トラブルシューティング

Inspector ツールのインストール

以下のコマンドを使用して、Inspector ツールをインストールして実行します。

npm install -g @inspector-rs/cli
inspector init

Inspector の起動

プロジェクトのルートディレクトリで Inspector を起動します。

inspector run

⚠️ 注意事項

• Virtuoso サービスが実行中で、正しく構成されていることを確認してください。
• odbc ドライバーが正しくインストールされ、システムで使用可能であることを確認してください。
• 接続問題が発生した場合は、データソース名と資格情報が正しいことを検証してください。

以上の手順に従うことで、MCP プロトコルの ADO.NET サーバーを正常に設定して実行し、Virtuoso データベースとの相互作用を行うことができます。