🚀 MCP 服务器文档

本项目文档详细介绍了 MCP 服务器，该服务器主要用于与模型上下文协议（Model Context Protocol）配合使用，为用户提供了与多种数据库和工具交互的能力。

🚀 快速开始

可用的 MCP 服务器

PostgreSQL 服务器

• 简介：PostgreSQL 服务器允许通过模型上下文协议连接到多个 PostgreSQL 数据库实例。
• 主要工具：
  • db1：用于默认数据库连接，支持 SSL 加密。
  • analytics：用于分析数据库连接，支持 SSL 加密。
• 使用示例：

curl -X GET "http://localhost:3000/api/db1/sql?query=SELECT%20*%20FROM%20users"

Obsidian 服务器

• 简介：Obsidian 服务器用于与 Obsidian 笔记程序交互。
• 主要工具：
  • read：读取笔记内容。
  • write：写入新笔记。
• 使用示例：

curl -X POST "http://localhost:3001/api/write" -H "Content-Type: application/json" -d '{"title":"新的笔记","content":"这是我的第一条笔记。"}'

n8n 服务器

• 简介：n8n 服务器用于与 n8n 流程自动化工具交互。
• 主要工具：
  • trigger：触发预定义的流程。
  • execute：执行特定任务。
• 使用示例：

curl -X POST "http://localhost:3002/api/trigger?flowId=123"

📦 安装指南

PostgreSQL 服务器设置

1. 进入 PostgreSQL MCP 目录：

cd postgresql-mcp

2. 安装依赖项并构建：

npm install
npm run build

3. 构建完成的文件位于 build/index.js。

Obsidian 服务器设置

1. 在 Obsidian 中安装 Local REST API 插件：

• 打开 Obsidian 设置 → 社区插件。
• 浏览并安装 "Local REST API" 插件。
• 启用插件并复制 API 密钥。

2. 进入 Obsidian MCP 目录：

cd obsidian-mcp

3. 以开发模式安装包：

pip install -e .

4. 在 .env 文件或 MCP 配置中设置 API 密钥。

n8n 服务器设置

1. 设置 n8n 实例并创建 API 密钥：

• 登录到 n8n 实例。
• 进入 Settings → API，创建新的 API 密钥并复制。

2. 进入 n8n MCP 目录：

cd n8n-mcp

3. 安装依赖项并构建：

npm install
npm run build

4. 在 .env 文件或 MCP 配置中设置 n8n URL 和 API 密钥。

📚 详细文档

配置文件示例

编辑 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\"}"
      }
    },
    "obsidian-mcp": {
      "command": "python",
      "args": ["-m", "obsidian_mcp.server"],
      "env": {
        "OBSIDIAN_API_KEY": "your_api_key"
      }
    },
    "n8n-mcp": {
      "command": "node",
      "args": ["/path/to/n8n_mcp/build/index.js"],
      "env": {
        "N8N_URL": "http://localhost:5678",
        "N8N_API_KEY": "your_api_key"
      }
    }
  }
}

调试说明

日志文件

• PostgreSQL MCP：日志文件位于 build/logs/postgres.log。
• Obsidian MCP：日志文件位于 obsidian_mcp/log/server.log。
• n8n MCP：日志文件位于 n8n_mcp/build/n8n.log。

使用 MCP Inspector

1. 检查 PostgreSQL 服务器：

node inspector.js http://localhost:3000

2. 检查 Obsidian 服务器：

python -m obsidian_mcp.inspector

3. 检查 n8n 服务器：

node inspector.js http://localhost:3002

🔧 技术细节

安全注意事项

• 凭据保护：请确保所有数据库凭据和 API 密钥仅通过环境变量传递，避免硬编码在代码中。
• 网络隔离：建议将 MCP 服务器部署在受信任的网络环境中，限制外部访问。
• 定期更新：及时更新服务器软件以防范已知安全漏洞。