麦普服务器

Name: 麦普服务器
Author: mericozkayagan

作者：mericozkayagan2 星标更新：2025-11-17

安装使用来源：spider==github.com

项目介绍

Cursor AI 的 MCP 服务器

此仓库包含用于 Cursor AI 的模型上下文协议（MCP）服务器设置，支持与外部工具和数据库的集成。

可用的 MCP 服务器

1. PostgreSQL MCP 服务器

这是一个功能齐全的模型上下文协议（MCP）服务器，提供 PostgreSQL 数据库管理能力。该服务器帮助分析现有的 PostgreSQL 设置，提供实现指导，调试数据库问题，管理模式，迁移数据，并监控数据库性能。

位置：./postgresql-mcp/
特性：数据库分析、模式管理、数据迁移、监控
来源：HenkDz/postgresql-mcp-server

主要工具

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 中的使用示例

"分析我位于 postgresql://user:password@localhost:5432/dbname 的 PostgreSQL 数据库"
"显示我 PostgreSQL 数据库中用户表的模式"
"创建一个具有 id、name、price 和 created_at 列的新产品表"
"监控我的数据库性能并显示任何耗时超过 30 秒的查询"

2. Obsidian MCP 服务器

这是一个通过 Local REST API 插件使 AI 能够与 Obsidian.md 笔记和保险库进行交互的服务器。这允许您直接从 Cursor AI 搜索、读取和写入您的 Obsidian 保险库中的内容。

位置：./obsidian-mcp/
特性：列出文件、搜索笔记、读取和写入内容
来源：MarkusPfundstein/mcp-obsidian
需要：安装了 Local REST API 插件的 Obsidian

主要工具

list_files_in_vault：列出您的 Obsidian 保险库中的所有文件
list_files_in_dir：列出特定目录中的文件
get_file_contents：获取特定笔记的内容
simple_search：在您的保险库中搜索文本匹配项
complex_search：高级模式匹配搜索
patch_content：将内容插入现有笔记
append_content：向新或现有笔记添加内容
batch_get_file_contents：一次检索多个文件

在 Cursor AI 中的使用示例

"列出我的 Obsidian 保险库中的所有文件"
"获取名为 '项目需求' 的笔记内容"
"在我的保险库中搜索所有提到 '机器学习' 的地方"
"创建一个名为 '会议总结' 的新笔记，其中包含最新项目会议的总结"
"在我的 '每日笔记' 文件下 '任务' 标题下添加今天的任务"

3. n8n MCP 服务器

这是一个通过 n8n API 提供与 n8n 实例集成的服务器，使您能够直接从 Cursor AI 管理和执行工作流。使用 MCP SDK 进行标准化通信构建。

位置：./n8n-mcp/
特性：列出工作流、管理工作流状态、执行工作流、查看执行情况
需要：具有 API 访问权限的 n8n 实例
实现：使用带有 Zod 验证的 Model Context Protocol 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 服务器

这是一个使用 Google 的 Gemini 2.5 Flash 图像模型提供 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
安装了 Local 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 服务器安装

在 Obsidian 中安装 Local REST API 插件：
- 打开 Obsidian 设置 → 社区插件
- 浏览“Local REST API”并安装
- 启用插件并从设置中复制 API 密钥
导航到 Obsidian MCP 目录：
```
cd obsidian-mcp
```
以开发模式安装包：
```
pip install -e .
```
在 .env 文件或 MCP 配置中设置您的 API 密钥

n8n 服务器安装

设置 n8n 实例并创建 API 密钥：
- 登录到您的 n8n 实例
- 转到设置 → API
- 创建一个新的具有适当权限的 API 密钥
- 复制 API 密钥
导航到 n8n MCP 目录：
```
cd n8n-mcp
```
安装依赖并构建：
```
npm install
npm run build
```
在 .env 文件或 MCP 配置中设置您的 n8n URL 和 API 密钥

Gemini 图像服务器安装

获取 Google Gemini API 密钥：
- 访问 Google AI Studio
- 创建或登录您的 Google 账户
- 生成 API 密钥
导航到 Gemini 图像 MCP 目录：
```
cd gemini-image-mcp
```
安装依赖并构建：
```
npm install
npm run build
```
服务器将被构建到 build/index.js
（可选）自定义配置：
- 编辑 src/config.ts 以调整图像尺寸、输出路径或其他设置
- 修改后再次运行 npm run build

Cursor 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
Obsidian MCP 日志：~/Library/Logs/Cursor/mcp-server-mcp-obsidian.log
n8n MCP 日志：~/Library/Logs/Cursor/mcp-server-n8n-mcp.log
Gemini 图像 MCP 日志：~/Library/Logs/Cursor/mcp-server-gemini-image-mcp.log

使用 MCP Inspector

对于 PostgreSQL：

npx @modelcontextprotocol/inspector node /path/to/postgresql-mcp/build/index.js

对于 Obsidian：

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 连接字符串包含敏感凭证 - 尽可能使用环境变量
Obsidian MCP 服务器对您的笔记具有读写访问权限 - 仔细审查权限
n8n API 密钥提供对您的工作流的访问 - 使用具有适当权限的 API 密钥
Gemini API 密钥提供对 Google 图像生成服务的访问 - 绝不要将其提交到版本控制系统
Gemini 服务器验证输出路径以防止目录遍历攻击
所有服务器都在您的本地计算机上运行，默认情况下不会暴露服务到网络