使用说明
用于Cursor AI的MCP服务器
此存储库包含Cursor AI的模型上下文协议(MCP)服务器设置,可与外部工具和数据库集成。
可用的MCP服务器
PostgreSQL MCP服务器
一个功能齐全的模型上下文协议(MCP)服务器,提供PostgreSQL数据库管理功能。该服务器协助分析现有的PostgreSQL设置,提供实现指导,调试数据库问题,管理模式,迁移数据和监控数据库性能。
- 位置:
./postgresql-mcp/ - 特性:数据库分析、模式管理、数据迁移、监控
- 来源: HenkDz/postgresql-mcp服务器
主要工具
analyze_database:分析PostgreSQL配置和性能get_setup_instructions:获取PostgreSQL的分步设置指南debug_database:调试常见的PostgreSQL问题get_schema_info:检索数据库架构信息create_table,alter_table:管理数据库表export_table_data,import_table_data:在格式之间迁移数据copy_between_databases:在PostgreSQL实例之间复制数据monitor_database:PostgreSQL指标的实时监控
Cursor AI中的使用示例
- “在p分析我的PostgreSQL数据库ostgresql://user:password@本地主机:5432/dbname“
- “显示PostgreSQL数据库中用户表的模式”
- 创建一个包含id、name、price和created_at列的新产品表
- “监控我的数据库性能,并向我显示任何超过30秒的查询”
2.黑曜石MCP服务器
通过本地REST API插件实现与Obsidian.md笔记和保险库的人工智能交互的服务器。这允许您直接从Cursor AI搜索、读取和写入黑曜石保险库中的内容。
- 位置:
./obsidian-mcp/ - 特性:列出文件、搜索笔记、读写内容
- 来源: 马库斯·普芬德斯坦/mcp黑曜石
- 需要:安装了本地REST API插件的Obsidian
主要工具
list_files_in_vault:列出黑曜石保管库中的所有文件list_files_in_dir:列出特定目录中的文件get_file_contents:获取特定注释的内容simple_search:在vault中搜索文本匹配项complex_search:使用模式匹配进行高级搜索patch_content:将内容插入到现有笔记中append_content:向新笔记或现有笔记添加内容batch_get_file_contents:一次检索多个文件
Cursor AI中的使用示例
- “列出我黑曜石保险库中的所有文件”
- “获取我的笔记中名为“项目要求”的内容”
- “在我的保险库中搜索所有提及‘机器学习’的内容”
- “创建一个名为“会议摘要”的新笔记,其中包含最新项目会议的摘要”
- “将今天的任务添加到我的‘每日笔记’文件的‘任务’标题下”
3.n8n MCP服务器
通过n8n API提供与n8n实例集成的服务器,可直接从Cursor AI进行工作流管理和执行。与MCP SDK一起构建,用于标准化通信。
- 位置:
./n8n-mcp/ - 特性:列出工作流、管理工作流状态、执行工作流、查看执行情况
- 需要:具有API访问权限的n8n实例
- 实施:使用带有Zod验证的模型上下文协议SDK
主要工具
mcp_list_workflows:列出n8n实例中的所有工作流mcp_get_workflow:按ID获取特定工作流的详细信息mcp_activate_workflow:按ID激活特定工作流mcp_deactivate_workflow:按ID停用特定工作流mcp_execute_workflow:使用可选输入数据执行特定工作流mcp_list_workflow_executions:列出特定工作流的执行情况mcp_get_execution:按ID获取特定执行的详细信息
Cursor AI中的使用示例
- “列出n8n实例中的所有工作流”
- “显示工作流X的详细信息”
- “激活工作流Y,使其开始监听触发器”
- “使用此输入数据执行工作流Z”
- “显示工作流X的所有最近执行情况”
- “获取运行ABC的执行详细信息”
4.Gemini映像MCP服务器
使用谷歌Gemini 2.5 Flash image模型提供AI图像生成功能的服务器。直接从文本描述生成高质量图像,完全控制大小、输出位置和生成参数。
- 位置:
./gemini-image-mcp/ - 特性:文本到图像生成、多种尺寸、可定制输出、流媒体支持
- 需要:Google Gemini API密钥
- 实施:内置MCP SDK,参数完全可配置
主要工具
generate_image:根据具有可自定义参数的文本提示生成图像- 支持多种图像大小(256px、512px、1K、2K、4K)
- 可配置的输出目录和文件命名
- 生成图像的可选AI文本描述
- 自动文件管理和验证
Cursor AI中的使用示例
- “生成海洋上日落的图像”
- “用飞行汽车生成一个未来城市的4K图像”
- “生成一个可爱机器人的图像,保存到.my images/”
- “生成浮岛上一座梦幻城堡的2K图像,命名为castle_concept.png”
- “生成现代极简主义咖啡机的图像,产品摄影风格”
配置
所有设置在中都是高度可配置的 src/config.ts:
- 图像大小和默认大小
- 输出目录和文件命名模式
- 模型选择和响应方式
- 请求超时和并发限制
- 验证规则和安全设置
- 日志记录和调试选项
安装说明
先决条件
- Node.js 18或更高版本
- Python 3.11或更高版本,带pip
- 安装了本地REST API插件的Obsidian.md(用于Obsidian集成)
- PostgreSQL数据库(用于PostgreSQL集成)
- 具有API访问权限的n8n实例(用于n8n集成)
- Google Gemini API密钥(用于Gemini图像集成)
PostgreSQL服务器设置
-
导航到PostgreSQL MCP目录:
cd postgresql-mcp -
安装依赖项并构建:
npm install npm run build -
服务器将被构建为
build/index.js
黑曜石服务器设置
-
在Obsidian中安装本地REST API插件:
- 打开黑曜石设置→ 社区插件
- 浏览“本地REST API”并安装
- 启用插件并从设置中复制API密钥
-
导航到Obsidian MCP目录:
cd obsidian-mcp -
在开发模式下安装软件包:
pip install -e . -
在中设置API密钥
.env文件或MCP配置中
n8n服务器设置
-
设置n8n实例并创建API密钥:
- 登录您的n8n实例
- 前往设置→ API
- 创建具有适当权限的新API密钥
- 复制API密钥
-
导航到n8n MCP目录:
cd n8n-mcp -
安装依赖项并构建:
npm install npm run build -
在中设置n8n URL和API密钥
.env文件或MCP配置中
Gemini映像服务器设置
-
获取Google Gemini API密钥:
- 访问 谷歌人工智能工作室
- 创建或登录您的Google帐户
- 生成API密钥
-
导航到Gemini Image MCP目录:
cd gemini-image-mcp -
安装依赖项并构建:
npm install npm run build -
服务器将被构建为
build/index.js -
(可选)自定义配置:
- 编辑
src/config.ts调整图像大小、输出路径或其他设置 - 跑
npm run build再次更改后
- 编辑
光标AI的配置
在以下位置编辑Cursor AI MCP配置文件 ~/.cursor/mcp.json:
{
"mcpServers": {
"postgresql-mcp": {
"command": "node",
"args": ["/path/to/mcp-servers/postgresql-mcp/build/index.js"],
"env": {
"PG_DB_MAP": "{\"db1\":\"postgresql://username:password@hostname:5432/database_name?sslmode=require\",\"analytics\":\"postgresql://analytics_user:secure_password@analytics-db.example.com:5432/analytics?sslmode=require\",\"default\":\"db1\"}"
}
},
"mcp-obsidian": {
"command": "/path/to/python/bin/mcp-obsidian",
"args": [],
"env": {
"OBSIDIAN_API_KEY": "your_api_key_here"
}
},
"n8n-mcp": {
"command": "node",
"args": ["/path/to/mcp-servers/n8n-mcp/build/index.js"],
"env": {
"N8N_BASE_URL": "https://your-n8n-instance.example.com",
"N8N_API_KEY": "your_api_key_here"
}
},
"gemini-image-mcp": {
"command": "node",
"args": ["/path/to/mcp-servers/gemini-image-mcp/build/index.js"],
"env": {
"GEMINI_API_KEY": "your_gemini_api_key_here"
}
}
}
}
将路径、连接详细信息和API键替换为实际值。
调试
日志文件
- PostgreSQL MCP日志:
~/Library/Logs/Cursor/mcp-server-postgresql-mcp.log - 黑曜石MCP日志:
~/Library/Logs/Cursor/mcp-server-mcp-obsidian.log - n8n MCP日志:
~/Library/Logs/Cursor/mcp-server-n8n-mcp.log - Gemini Image MCP日志:
~/Library/Logs/Cursor/mcp-server-gemini-image-mcp.log
使用MCP检查器
对于PostgreSQL:
npx @modelcontextprotocol/inspector node /path/to/postgresql-mcp/build/index.js
对于黑曜石:
npx @modelcontextprotocol/inspector /path/to/python/bin/mcp-obsidian
对于n8n:
npx @modelcontextprotocol/inspector node /path/to/n8n-mcp/build/index.js
对于Gemini图像:
npx @modelcontextprotocol/inspector node /path/to/gemini-image-mcp/build/index.js
确保设置 GEMINI_API_KEY 运行检查器之前的环境变量。
安全考虑
- PostgreSQL连接字符串包含敏感凭据-尽可能使用环境变量
- 黑曜石MCP服务器具有对您笔记的读/写权限-请仔细查看权限
- n8n API密钥提供对工作流的访问-使用具有适当权限的API密钥
- Gemini API密钥提供对谷歌图像生成服务的访问-永远不要将其用于版本控制
- Gemini服务器验证输出路径以防止目录遍历攻击
- 所有服务器都在您的计算机上本地运行,默认情况下不会向网络公开服务
