AdoMcp
一个开箱即用的数据库 Model Context Protocol (MCP) Server，让 AI Agent 能够发现数据库对象、理解表结构和注释、检查索引，并安全地执行 SQL。
A ready-to-run database MCP server for schema discovery, comments, indexes, and controlled SQL execution.
支持 SQL Server、MySQL/MariaDB、PostgreSQL、SQLite 和 Oracle；插件核心遵循 Agent Plugins（Open Plugin Spec）1.0，可用于 Codex、Claude Code、GitHub Copilot App 和 Copilot CLI。
Server name 和 version 由 MCP SDK 根据程序集元数据自动生成；Server 会在 MCP initialize/server/discover 响应中返回根级 instructions，指导客户端先定位连接与对象、只用 query_sql 读数据，并仅在明确授权后调用 execute_sql。
功能
前置要求
- .NET 10 SDK
- 使用插件时，客户端需要允许启动本地
dnx进程
无需提前安装 AdoMcp。插件和示例配置使用 dnx -y AdoMcp，首次运行时会从 NuGet 获取包。
插件安装
仓库根目录的 plugin.json、mcp.json 和 skills/adomcp/SKILL.md 是通用的 Agent Plugins 1.0 插件核心。.codex-plugin/、.claude-plugin/、.mcp.json 和 marketplace 文件是客户端兼容与分发入口。插件默认以 stdio 启动 AdoMcp，且不会开启写 SQL。
Codex
仓库包含 .codex-plugin/plugin.json，可被 Codex 插件市场或本地插件源使用。若只需要 MCP Server，可直接添加：
codex mcp add adomcp -- dnx -y AdoMcp
Claude Code（cc）
/plugin marketplace add John0King/AdoMCP
/plugin install adomcp@adomcp-plugins
安装后执行 /reload-plugins；使用 /mcp 检查 adomcp 是否已连接。
GitHub Copilot CLI
可以从 GitHub 仓库直接安装：
copilot plugin install John0King/AdoMCP
copilot mcp get adomcp
也可以通过 marketplace 安装：
copilot plugin marketplace add John0King/AdoMCP
copilot plugin install adomcp@adomcp-plugins
GitHub Copilot App
在 Copilot App 中打开 Customize → Plugins，添加 John0King/AdoMCP marketplace，然后安装 AdoMcp。本仓库的 .github/plugin/marketplace.json、plugin.json、.mcp.json 和 skill 会作为一个插件加载。
Copilot App/云端 Agent 必须能运行 .NET 10 和访问 NuGet，才能启动这个本地 stdio MCP Server。若运行环境不允许本地进程，请先自行以 HTTP 模式部署 AdoMcp，再按下文配置远程地址。
直接配置 MCP
适用于任何支持本地 MCP 的客户端：
{
"mcpServers": {
"adomcp": {
"command": "dnx",
"args": ["-y", "AdoMcp"]
}
}
}
HTTP 模式需先启动服务：
dnx -y AdoMcp -- --http
然后连接端点：
{
"mcpServers": {
"adomcp": {
"url": "http://localhost:5100/mcp"
}
}
}
数据库连接配置
AdoMcp 按以下顺序加载配置，后面的来源覆盖前面的来源：
- 应用目录中的
appsettings.json appsettings.{Environment}.json- 用户配置
~/.adomcp.json（Windows 为%USERPROFILE%\.adomcp.json） ADOMCP_前缀的环境变量- .NET User Secrets
- 命令行
--allow-any-sql（覆盖全局AllowAnySql，影响动态连接及未单独设置权限的静态连接）
最常用的方式是在用户目录创建 .adomcp.json：
{
"AllowAnySql": false,
"Databases": [
{
"Name": "mydb",
"DbType": "PostgreSql",
"ConnectionString": "Host=localhost;Database=app;Username=postgres;Password=***;",
"AllowAnySql": false,
"Description": "Local development database"
}
]
}
DbType 可选值：SqlServer、MySql、PostgreSql、Sqlite、Oracle。
静态连接显式设置 AllowAnySql 时使用自身的值；省略时继承全局 AllowAnySql。动态连接也继承全局值，不能单独指定。全局值可在配置文件、ADOMCP_ALLOWANYSQL 环境变量或启动参数中设置，命令行优先，默认 false。权限在进程启动时确定；list_connections 的 canWrite 列显示当前生效的权限。
也可以不创建配置文件，让 Agent 在会话中调用 add_connection。动态连接继承启动时确定的全局 AllowAnySql，仅在当前 AdoMcp 进程中有效，重启后不会保留。同名动态连接会覆盖静态连接，直到移除该动态连接。
不要把真实连接字符串提交到 Git。生产环境建议使用环境变量、User Secrets 或客户端的密钥管理能力。
运行模式
默认使用 stdio；stdout 仅传输 MCP JSON-RPC，日志写入 stderr。
# 默认 stdio
dnx -y AdoMcp
# 显式 stdio（兼容旧配置）
dnx -y AdoMcp -- --stdio
# HTTP，默认监听 http://localhost:5100/mcp
dnx -y AdoMcp -- --http
# 安装为全局 .NET tool
dotnet tool install -g AdoMcp
adomcp
写 SQL 安全开关
execute_sql 按目标连接判断。静态连接可以显式设置 "AllowAnySql": true 开启写入，或省略该项来继承全局设置；动态连接始终继承全局设置。例如：
dnx -y AdoMcp -- --allow-any-sql
dnx -y AdoMcp -- --http --allow-any-sql
也可以在配置文件中设置顶层 "AllowAnySql": true，或设置环境变量 ADOMCP_ALLOWANYSQL=true。运行中修改配置文件不会改变当前进程的写入权限。对于必须保证只读的数据库，请同时使用仅有读取权限的数据库账号；query_sql 的 SQL 文本检查不能替代数据库权限。
Agent 推荐工作流
- 用
list_connections确认连接。 - 缺少连接时用
add_connection添加。 - 用
list_objects确认 schema、对象类型和对象名。 - 用
get_table_schema查看结构和注释。 - 涉及键或性能时用
get_table_indexes。 - 只读验证使用
query_sql。 - 仅在用户明确授权且 Server 开启写入能力时使用
execute_sql。
Oracle 中未带 owner 的对象可能是 synonym，应先通过 list_objects 解析真实 schema。
环境变量
MCP Registry
AdoMcp 已注册到官方 MCP Registry，Server name 为 io.github.John0King/adomcp。