AdoMcp

Name: AdoMcp
Author: John0King

作者：John0King版本 1.5.0i★ –i在你的电脑上运行

注册名称io.github.John0King/adomcp

安装

概览

作者提供的说明（英文原文）

Database MCP server for schema discovery, comments, and SQL queries.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数：意见、测量和人气是不同的东西。

用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
我们的基础检查i1 项中通过 1 项依据公开信息检查；尚未扫描代码
使用情况i尚未统计★ –

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

连接方式: 在你的电脑上运行
传输方式: stdio
分类: 数据库与数据集

安装

选择你使用的 AI 应用，然后复制设置。

安装之前

基础检查：1 项中通过 1 项
在你的电脑上运行，拥有你的用户账户的权限（文件、网络、应用）。
注册中心没有列出需要填写的密钥。

你用的是哪个应用？

ClaudeClaude CodeCursorVS CodeChatGPT

在上方选择你的应用。我们会记住它，下次按钮会显示“安装到 …”。

打开 Claude Desktop → Settings → Developer → Edit Config，把下面的内容粘贴到 claude_desktop_config.json

{
  "mcpServers": {
    "adomcp": {
      "command": "dnx",
      "args": [
        "adomcp",
        "--yes"
      ]
    }
  }
}

在终端中运行这条命令

claude mcp add adomcp -- dnx adomcp --yes

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json，或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "adomcp": {
      "command": "dnx",
      "args": [
        "adomcp",
        "--yes"
      ]
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "adomcp": {
      "type": "stdio",
      "command": "dnx",
      "args": [
        "adomcp",
        "--yes"
      ]
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

这个服务器在你的电脑上运行，而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。

你的选择通过 Cookie 保存在这台设备上，无需账户。

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。

它能做什么

它在你的电脑上运行；安装后，工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月7日

✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 John0King 验证，该账户拥有此仓库
… 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
… 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
– 不适用
端点有响应
它在你的电脑上运行，没有互联网端点
– 不适用
使用 OAuth 登录
在你的电脑上运行，改用本地设置
… 尚未检查
工具描述中没有隐藏指令
它在你的电脑上运行；我们只能读取互联网端点的工具列表

与“数据库与数据集”中的其他服务器比较i

星标数多于此分类中其他 953 个服务器的 0%
发布到注册中心的时间比此分类中其他 953 个服务器的 84% 更新
基础检查结果等于或优于此分类中其他 953 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

AdoMcp 安全吗？

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

注册中心没有列出必需的密钥，不过有些服务器会在首次使用时要求你登录。

它在我的电脑上运行还是在云端？

它在你的电脑上运行。你的 AI 应用会在需要时启动它，数据不会经过作者的服务器（除非它自己调用在线服务）。

它还在维护吗？

GitHub 仓库最后更新于–，最新版本（1.5.0）于7天前进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 .NET。

有什么可以替代它？

同一分类中有：Supabase, MongoDB MCP Server, Elasticsearch MCP Server

替代选择

同一分类中其他作者的服务器，按星标数排序。

如何看卡片：★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Supabase

作者：supabase

MCP server for interacting with the Supabase platform

电脑或云端★ 2,993Apache-2.0今天更新

安装

MongoDB MCP Server

作者：mongodb-js

MongoDB Model Context Protocol Server

在你的电脑上运行★ 1,157Apache-2.0前天更新

安装

Elasticsearch MCP Server

作者：cr7258

MCP server for interacting with Elasticsearch

在你的电脑上运行★ 315Apache-2.014个月前更新

安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

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。

功能

Tool	说明
`list_connections`	列出已配置的数据库连接
`add_connection`	在当前进程中新增或替换连接
`remove_connection`	删除运行时新增的连接
`list_objects`	查找表、视图、存储过程、函数、触发器、序列和同义词等对象
`get_table_schema`	获取字段、类型、可空性、主键、默认值和注释
`get_table_indexes`	获取表索引
`query_sql`	执行只读 SQL，返回 CSV
`execute_sql`	执行写 SQL；默认禁用，需显式启用

数据库	驱动	注释支持
SQL Server	`Microsoft.Data.SqlClient`	`MS_Description` 扩展属性
MySQL / MariaDB	`MySqlConnector`	`TABLE_COMMENT` / `COLUMN_COMMENT`
PostgreSQL	`Npgsql`	`obj_description` / `col_description`
SQLite	`Microsoft.Data.Sqlite`	SQLite 无原生注释
Oracle	`Oracle.ManagedDataAccess.Core`	`ALL_TAB_COMMENTS` / `ALL_COL_COMMENTS`，包含 PUBLIC synonym

前置要求

.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。运行中修改配置文件不会改变当前进程的写入权限。查询和写入使用同一个连接配置，由服务端执行入口检查 SQL 与写入权限。

query_sql 接受单条 SELECT 或 WITH 查询，可带一个末尾分号。检查时跳过字符串、引用标识符和普通注释，拦截写入、DDL、过程调用与事务控制关键字；例如 SELECT 'DELETE' 可以执行，SELECT ... INTO ...、修改数据的 CTE 和多语句批次会被拒绝。MySQL/MariaDB 可执行注释及引用文本中的反斜杠会因语义不明确而被拒绝。此检查是保守的词法过滤，并不解析完整 SQL，也无法识别数据库函数内部的副作用。未引用的名称若命中拦截关键字，也会被拒绝。

内部职责与验证

ConnectionRegistry：保存启动配置快照、管理动态连接覆盖，并返回包含生效写入策略的配置副本。
DatabaseService：获取元数据、执行查询或写入；查询调用 SqlQueryGuard，写入检查当前配置的权限。
DbConnections：创建和打开 ADO.NET 连接，打开失败时释放连接；调用方负责正常路径的释放。
IDbProvider：保留各数据库的元数据查询实现。
DatabaseTools：MCP 参数及 CSV/JSON 输出，将异常转成工具错误，取消请求则继续传播。

执行 dotnet test AdoMcp.slnx 验证 SQL 过滤、连接配置覆盖与权限、取消行为及 SQLite 查询/写入/元数据调用。

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。

环境变量

变量	说明
`ADOMCP_MODE`	`stdio` 或 `http`
`ADOMCP_URLS`	HTTP 监听地址，例如 `http://0.0.0.0:5100`
`ADOMCP_ALLOWANYSQL`	动态连接及未单独设置权限的静态连接的全局写入默认值，默认 `false`
`ADOMCP_DATABASES`	JSON 编码的 `Databases` 数组

MCP Registry

AdoMcp 已注册到官方 MCP Registry，Server name 为 io.github.John0King/adomcp。

License

MIT

AdoMcp

概览

PopNx MCP 的三大支柱

它能帮你做什么

安装

安装之前

它能做什么

基础检查i

作者与仓库一致

仍在维护

有许可证

端点有响应

使用 OAuth 登录

工具描述中没有隐藏指令

与“数据库与数据集”中的其他服务器比较i

常见问题

替代选择

Supabase

MongoDB MCP Server

Elasticsearch MCP Server

作者的 README

AdoMcp

功能

前置要求

插件安装

Codex

Claude Code（cc）

GitHub Copilot CLI

GitHub Copilot App

直接配置 MCP

数据库连接配置

运行模式

显式 stdio（兼容旧配置）

HTTP，默认监听 http://localhost:5100/mcp

安装为全局 .NET tool

写 SQL 安全开关

内部职责与验证

Agent 推荐工作流

环境变量

MCP Registry

License