MCP Adonet Server

🚀 MCP 協議 ADO.NET 服務器（適用於 Virtuoso）

本項目的 MCP 協議 ADO.NET 服務器可助力您與 Virtuoso 數據庫實現高效交互，提供數據庫查詢、SPARQL 查詢等功能，還支持 SQL/SPARQL 混合查詢以及 AI 支持功能。

🚀 快速開始

安裝與配置

安裝 .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 支持功能。

📦 安裝指南

安裝 .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        =

💻 使用示例

基礎用法

基本查詢

通過以下命令測試基本查詢功能：

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 數據庫進行交互。