go-mcp-postgres

概述

从https://github.com/Zhwt/go-mcp-mysql/复制代码，在 AI 的帮助下，我将数据库从 mysql 更改为 postgres。零负担、即用型模型上下文协议 (MCP) 服务器，用于与 Postgres 和自动化交互。无需 Node.js 或 Python 环境。该服务器提供对 MySQL 数据库和表执行 CRUD 操作的工具，以及用于防止意外写入操作的只读模式。您还可以通过添加--with-explain-check标志，让 MCP 服务器在执行查询之前使用EXPLAIN语句检查查询计划。

请注意，这是一项正在进行的工作，可能尚未准备好投入生产使用。

Related MCP server: Filesystem MCP Server

安装

获取最新版本并将其放在您的$PATH或您可以轻松访问的地方。
或者如果你已经安装了 Go，你可以从源代码构建它：

go install -v github.com/guoling2008/go-mcp-postgres@latest

用法

方法 A：使用 stdio 模式的命令行参数

{ "mcpServers": { "postgres": { "command": "go-mcp-postgres", "args": [ "--dsn", "postgresql://user:pass@host:port/db" ] } } }

注意：对于将二进制文件放在$PATH之外的人，您需要将go-mcp-postgres替换为二进制文件的完整路径：例如：如果将二进制文件放在下载文件夹中，则可以使用以下路径：

{ "mcpServers": { "postgres": { "command": "C:\\Users\\<username>\\Downloads\\go-mcp-postgres.exe", "args": [ ... ] } } }

方法 B：使用 sse 模式的命令行参数

./go-mcp-postgres --t sse --ip xxxx --port nnnn --dsn postgresql://user:pass@host:port/db --lang en

可选标志

--lang ：设置语言选项（en/zh-CN），默认为系统语言
添加--read-only标志以启用只读模式。在此模式下，只有以list 、 read_和desc_开头的工具可用。添加此标志后，请务必刷新/重启 MCP 服务器。
默认情况下，CRUD 查询将首先使用EXPLAIN ?语句执行，以检查生成的查询计划是否符合预期模式。添加--with-explain-check标志可禁用此行为。

工具

多语言支持：所有工具描述将根据语言参数自动本地化

如果您想添加自己的语言支持，请参考 [locales](for i18n) 文件夹。如果您想在命令行中使用，则需要创建新的 locales/xxx/active-xx.toml 文件。

架构工具

list_database
- ${mcp.tool.list_database.desc}
- 参数：无
- 返回：匹配的数据库名称列表。
list_table
- ${mcp.tool.list_table.desc}
- 参数：
  - name ：如果提供，则列出具有指定名称的表，否则，列出所有表。
- 返回：匹配的表名列表。
create_table
- ${mcp.tool.create_table.desc}
- 参数：
  - query ：创建表的 SQL 查询。
- 返回：受影响的 x 行。
alter_table
- 修改 Postgres 服务器中现有的表。LLM 被告知不要删除现有的表或列。
- 参数：
  - query ：用于修改表的 SQL 查询。
- 返回：受影响的 x 行。
desc_table
- 描述表的结构。
- 参数：
  - name ：要描述的表的名称。
- 返回：表的结构。

数据工具

read_query
- 执行只读 SQL 查询。
- 参数：
  - query ：要执行的 SQL 查询。
- 返回：查询的结果。
write_query
- 执行写入 SQL 查询。
- 参数：
  - query ：要执行的 SQL 查询。
- 返回：受影响的 x 行，最后插入 ID：<last_insert_id>。
update_query
- 执行更新 SQL 查询。
- 参数：
  - query ：要执行的 SQL 查询。
- 返回：受影响的 x 行。
delete_query
- 执行删除 SQL 查询。
- 参数：
  - query ：要执行的 SQL 查询。
- 返回：受影响的 x 行。
count_query
- 查询某个表的行数..
- 参数：
  - name ：要计数的表的名称。
- 返回：表的行号。