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 数据库进行交互。