🚀 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 系统
- 打开“控制面板”。
- 选择“系统和安全”，然后是“系统”。
- 点击“环境变量”。
- 在“系统变量”部分，找到并编辑
ODBCAD32变量（Windows 7 或更高版本）。 - 添加或配置 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 系统
- 打开“控制面板”。
- 选择“系统和安全”，然后是“系统”。
- 点击“环境变量”。
- 在“系统变量”部分，找到并编辑
ODBCAD32变量（Windows 7 或更高版本）。 - 添加或配置 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 数据库进行交互。