MCP服务器-连接密钥
一个MCP（模型上下文协议）服务器，为Cursor IDE提供各种有用的工具。
可用工具
服务器提供以下工具：
1. 拼
测试工具来检查服务器连接。
- 参数： 无
- 版本 ： “乒乓球”
2. 回声
返回输入的文本。有助于测试参数。
- 参数：
- text （string） 要返回的文本
- 版本 ： 输入的文本
3. getDateTime
返回当前日期和时间。
- 参数：
- timezone （字符串，可选）：Zeitzone（z.B.“欧洲/柏林”），标准：UTC
- 版本 ：
- dateTime格式化的日期/时间字符串 - timestamp：Unix时间戳 - timezone使用的时区
4. 计算
进行数学计算。
- 参数：
- expression （string）： 数学表达式（例如 '2 + 2'， '10 * 5'， '2 \*\* 3'）
- 支持的运营商： +， - ， \*， /， %， * （功率）
- 版本 ：
- result计算结果 - expression： 原始表达式
5. 生成UUID
UUID（Universally Unique Identifier）
- 参数：
- version （enum，可选）： UUID 版本 - “v4”（随机，默认）或“v1”（基于时间）
- 版本 ：
- uuid生成的 UUID - version： 使用的版本
n8n集成工具
6. 致电N8N
调用 n8n REST API。可以启动工作流、发送或检索数据。
- 参数：
- endpoint （字符串）：API终端（例如“/api/v1/workflows”或“/webhook/reading”） - method （枚举）：HTTP方法-GET、POST、PUT、DELETE、PATCH（标准：POST） - body （object，可选）：请求身体作为JSON对象 - headers （object， optional）： 额外的 HTTP 标头
- 版本 ：
- status：HTTP状态代码 - data答案数据 - success： 成功状态
7. 创建N8N工作流
创建具有指定名称和节点的新 n8n 工作流。
- 参数：
- name （string）：工作流名称 - nodes （array）：工作流节点数组 - active （boolean，可选）：启用工作流（默认：false） - tags （array， optional）：工作流标签
- 版本 ：
- workflowId创建的工作流 ID - name：工作流名称 - nodeCount节点数量 - message：状态
8. 触发器N8NWebhook
启动 n8n Webhook 工作流程。有助于启动自动化。
- 参数：
- webhookPath （string）：Webhook Pfad（z.B.“读取”、“匹配”、“图表分析”） - data （object）：要发送到 Webhook 的数据
- 版本 ：
- success： 成功状态 - executionId执行ID（可选） - message：状态
人体设计工具
9. generate阅读
根据出生数据生成人类设计读数。启动 n8n Workflow。
- 参数：
- birthDate （string）： YYYY-MM-DD格式的出生日期 - birthTime （string） HH:MM格式的出生时间 - birthPlace （string） 出生地 - userId （字符串，可选）：用户ID - readingType （枚举，可选）：阅读艺术-基本、详细、业务、关系（标准：基本）
- 版本 ：
- readingId生成的读数 ID - chartData图表数据 - reading：阅读文本 - success： 成功状态
10. 分析图表
分析人类设计图表数据并返回详细信息。
- 参数：
- chartData （object）：图表数据（类型、中心、通道等） - analysisType （枚举，可选）：Art der Analysis-类型、中心、通道、门、轮廓、完整（标准：完整）
- 版本 ：
- analysis： 分析结果 - summary摘要： - success： 成功状态
配套工具
11. matchPartner
在两个人之间进行人类设计合作伙伴匹配。
- 参数：
- user1Chart （object）：第一人称图表数据 - user2Chart （object）：第二人称图表数据 - matchingType （枚举，可选）：Art des Matchings-兼容性、关系、业务、完整（标准：兼容性） - userId1 （string， optional） 第一人称用户ID - userId2 （string， optional）：第二个人的用户ID
- 版本 ：
- matchId：匹配ID - compatibilityScore兼容性评分（0-100） - analysis： 详细分析 - recommendations建议作为数组 - success： 成功状态
用户数据工具
12. 保存用户数据
通过n8n Webhook存储用户数据。有助于应用程序用户登录和数据处理。
- 参数：
- userId （string）：用户ID - data （object）：要存储的数据 - dataType （枚举，可选）：日期艺术-配置文件、图表、读数、首选项、自定义（标准：自定义）
- 版本 ：
- success： 成功状态 - recordId存储记录的ID（可选） - message：状态
安装
地方发展
- 确保安装了Node.js
- 安装依赖关系：
npm install- 设置 n8n 连接：
- 打开 config.js - 适应 n8n.baseUrl 到您的 n8n 实例 - 可选：设置 N8N_API_KEY 如果需要，作为环境变量
或者设置环境变量：
# Windows PowerShell
$env:N8N_BASE_URL="https://n8n.deinedomain.tld"
$env:N8N_API_KEY="your-api-key"
# Linux/Mac
export N8N_BASE_URL="https://n8n.deinedomain.tld"
export N8N_API_KEY="your-api-key"Hetzner服务器部署
对于在Hetzner服务器上设置，有一个自动设置脚本：
快速启动 ：
# Auf Hetzner Server
curl -o setup-hetzner.sh https://raw.githubusercontent.com/Heiko888/Connection-Key-MCP-Server/main/setup-hetzner.sh
chmod +x setup-hetzner.sh
sudo ./setup-hetzner.sh更多信息：
- HETZNER_QUICKSTART.md - 快速设备
- 部署_赫兹纳.md - 详细说明
- ENV_SETUP_HETZNER.md .env 文件设置
在 Cursor IDE 中配置
要在 Cursor IDE 中使用 MCP 服务器，您需要在 Cursor 设置中配置它：
- 打开光标设置（文件→首选项→设置）
- 搜索“MCP”或“模型上下文协议”
- 添加以下配置：
{
"mcpServers": {
"mcp-server": {
"command": "node",
"args": [
"C:\\AppProgrammierung\\Projekte\\MCP_Connection_Key\\index.js"
],
"cwd": "C:\\AppProgrammierung\\Projekte\\MCP_Connection_Key"
}
}
}重要 ： 自定义路径到您的系统！
替代方案：使用mcp.json
文件 mcp.json 这个项目可以作为参考。将内容复制到您的光标配置。
服务器启动（ 手动）
要手动测试服务器：
npm start然后服务器通过stdio运行，等待cursor的连接。
错误修正
工具不显示
- 检查服务器连接：
- 确保在光标设置中正确配置服务器 - 检查配置中的路径
- 重新启动光标 ：
- 重新启动光标以加载 MCP 配置
- 检查日志：
- 在 Cursor 中打开输出面板 - 选择“MCP”或“模型上下文协议” - 查找错误消息
- 服务器手动测试：
- 领导 npm start 出自 - 服务器应该没有错误地启动
常见错误
- “找不到模块”：请确保
npm install已执行 - “EACCES”或权限错误检查文件权限
- “找不到命令”确保 Node.js 在 PATH 中
发展
添加新工具
要添加新工具，请使用 registerTool-方法：
server.registerTool(
"toolName",
{
title: "Tool Titel",
description: "Beschreibung des Tools",
inputSchema: z.object({
// Ihre Parameter hier
}),
outputSchema: z.object({
// Ihre Ausgabe hier
})
},
async (params) => {
// Ihre Tool-Logik hier
return {
content: [{ type: "text", text: "Ergebnis" }],
structuredContent: { /* strukturierte Daten */ }
};
}
);建筑
MCP 服务器是一个更大的架构的一部分：
App
↓
Connection-Key Server ←→ MCP Server
↓ ↑
n8n ←———————————————————组件 ：
- 应用发送用户愿望
- 连接密钥服务器中央API，控制n8n + MCP
- MCP服务器工具、人工智能代理、自动化（此服务器）
- n8n工作流、数据流、集成、数据处理
联系方式：
- 应用程序仅与连接密钥服务器通信
- 连接密钥服务器调用 n8n 工作流
- 连接密钥服务器使用 MCP 服务器作为代理框架
- MCP 服务器调用 n8n API/Webhooks
使用范例
示例1：生成人类设计阅读
// In Cursor können Sie jetzt sagen:
"Erstelle mir ein Human Design Reading für einen User, geboren am 1990-05-15 um 14:30 in Berlin"然后，MCP 服务器会自动调用 n8n Webhook 并生成读取。
示例 2：创建工作流程
"Erstelle einen n8n Workflow namens 'User Login Reading' mit 3 Nodes"例三：合作伙伴匹配
"Führe ein Partner-Matching zwischen User 123 und User 456 durch"技术细节
- 框架： @modelcontextprotocol/sdk v1.0.0+
- 方案验证 ： 萨德
- 运输： 标准输入/输出
- Node.js： 必需
- n8n集成： REST API 和 Webhooks
- 配置 ： 关于
config.js或环境变量
许可证
本项目仅供个人使用。