结点AI-MCP服务器

Name: 结点AI-MCP服务器
Author: avijeett007

作者：avijeett0072 星标更新：2025-06-04

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

项目介绍

Knotie AI Pro MCP 服务器

一个模型上下文协议（MCP）服务器，使像 Claude Desktop 这样的AI代理能够与 Knotie AI Pro 平台交互，实现自动化的客户管理和语音AI代理管理。

🚀 功能

客户管理：创建客户，启用门户访问，重置密码
代理管理：将AI代理映射到客户，更新配置，管理利润倍数
多平台支持：支持 Retell, VAPI, ElevenLabs, GoHighLevel
安全本地配置：API密钥存储在本地，从不传输给第三方
Claude Desktop 集成：无缝集成到 Claude Desktop 和其他 MCP 客户端

📋 先决条件

已安装 Node.js 18+
拥有一个具有 API 访问权限的 Knotie AI Pro 合作伙伴账户
Claude Desktop 或其他兼容 MCP 的客户端

🚀 快速开始

对于 NPM 用户（推荐）

# 1. 全局安装
npm install -g knotie-ai-mcp

# 2. 运行交互式设置
npm run setup
# 或手动创建配置：
mkdir -p ~/.knotie
echo '{"apiKey":"your-key","partnerEmail":"your-email@example.com","baseUrl":"https://knotie-ai.pro"}' > ~/.kknotie/config.json

# 3. 测试服务器
npx knotie-ai-mcp

# 4. 添加到 Claude Desktop 配置并重启 Claude

对于开发者（从源码）

# 1. 克隆并设置
git clone https://github.com/your-username/knotie-ai-mcp.git
cd knotie-ai-mcp
npm install && npm run build

# 2. 配置
cp config/knotie-config.example.json config/knotie-config.json
# 编辑 config/knotie-config.json 文件添加您的凭据

# 3. 测试
npm run dev

# 4. 将其添加到 Claude Desktop，使用完整的路径指向 build/index.js

🛠️ 安装

方案 1：NPM 安装（推荐）

# 全局安装
npm install -g knotie-ai-mcp

# 或者本地安装
npm install knotie-ai-mcp

全局安装故障排除

如果您在全局安装时遇到权限错误，您可以选择以下几种方法：

方案 A：使用 npm 的前缀标志（推荐）

# 创建一个用于全局包的目录
mkdir -p ~/npm-packages

# 使用自定义前缀安装
npm install --prefix ~/npm-packages -g knotie-ai-mcp

# 添加到您的 PATH（将此行添加到您的 ~/.bashrc 或 ~/.zshrc）
export PATH="$HOME/npm-packages/bin:$PATH"

方案 B：配置 npm 使用不同的目录

# 创建目录并配置 npm
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global

# 添加到您的 PATH（将此行添加到您的 ~/.bashrc 或 ~/.zshrc）
export PATH="$HOME/.npm-global/bin:$PATH"

# 然后安装
npm install -g knot-ai-mcp

方案 C：使用 npx（无需安装）

# 直接使用 npx 运行
npx knotie-ai-mcp

方案 2：从源码

# 克隆仓库
git clone https://github.com/knotie-ai/knotie-ai-mcp.git
cd knotie-ai-mcp

# 安装依赖
npm install

# 构建项目
npm run build

⚙️ 配置

MCP 服务器需要您的 Knotie AI Pro API 凭证。您可以通过两种方式配置这些凭证：

方法 1：环境变量（推荐）

直接在 Claude Desktop 配置中设置环境变量：

{
  "mcpServers": {
    "knotie-ai-pro": {
      "command": "node",
      "args": ["/绝对路径/to/knotie-ai-mcp/build/index.js"],
      "env": {
        "KNOTIE_API_KEY": "your-api-key-here",
        "KNOTIE_PARTNER_EMAIL": "your-partner-email@example.com",
        "KNOTIE_BASE_URL": "https://analytics.knotie-ai.pro"
      }
    }
  }
}

环境变量：

KNOTIE_API_KEY - 您的合作伙伴 API 密钥（必需）
KNOTIE_PARTNER_EMAIL - 您注册的合作伙伴电子邮件（必需）
KNOTIE_BASE_URL - 分析服务的基础 URL（可选，默认为 https://analytics.knotie-ai.pro）

优点：

✅ 不需要配置文件
✅ 凭证安全地存储在 Claude Desktop 中
✅ 适用于任何安装方法
✅ 类似于其他 MCP 服务器（GitHub 等）

方法 2：配置文件（替代方案）

方案 A：NPM 安装

如果您通过 NPM 安装了（npm install -g knotie-ai-mcp）：

创建配置目录：
```
mkdir -p ~/.knotie
```

创建配置文件：

# 创建配置文件
touch ~/.knotie/config.json

添加您的凭据：

{
  "apiKey": "your-api-key-here",
  "partnerEmail": "your-partner-email@example.com",
  "baseUrl": "https://analytics.knotie-ai.pro"
}

方法 2：从源码（克隆的仓库）

如果您克隆了仓库：

复制示例配置：

cp config/knotie-config.example.json config/knotie-config.json

编辑配置：

# 使用您的凭据编辑文件
nano config/knotie-config.json
# 或
code config/knotie-config.json

更新您的凭据：

{
  "apiKey": "your-actual-api-key",
  "partnerEmail": "your-actual-email@example.com",
  "baseUrl": "https://analytics.knotie-ai.pro"
}

配置文件位置（优先级顺序）

服务器按以下顺序查找配置：

./knotie-config.json（当前目录）
~/.knotie/config.json（家目录） - 推荐用于 NPM 安装
./config/knotie-config.json（相对于安装位置） - 对于源码安装

获取您的 API 凭证

登录到您的 Knotie AI Pro 合作伙伴仪表板
导航至设置 → API 密钥
创建一个新的 API 密钥
复制您的 API 密钥和合作伙伴电子邮件到配置文件中

🔧 Claude Desktop 设置

1. 安装 Claude Desktop

如果尚未安装，请下载并安装 Claude Desktop。

2. 配置 Claude Desktop

编辑您的 Claude Desktop 配置文件：

macOS/Linux:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows:

code %APPDATA%\Claude\claude_desktop_config.json

3. 添加 Knotie AI Pro 服务器

方案 A：环境变量（推荐）

{
  "mcpServers": {
    "knotie-ai-pro": {
      "command": "node",
      "args": ["/Users/avijitsarkar/Projects/Knotie-AI/knotie-ai-pro/knotie-ai-mcp/build/index.js"],
      "env": {
        "KNOTIE_API_KEY": "pkt_48405b5a31fec30a3be3480f7d2a56552488bb61fc81d63100ab83e8d792d3b6",
        "KNOTIE_PARTNER_EMAIL": "avijeett007@gmail.com",
        "KNOTIE_BASE_URL": "https://analytics.knotie-ai.pro"
      }
    }
  }
}

方案 B：NPM 安装与配置文件

{
  "mcpServers": {
    "knotie-ai-pro": {
      "command": "npx",
      "args": ["knotie-ai-mcp"]
    }
  }
}

方案 C：从源码与配置文件

{
  "mcpServers": {
    "knotie-ai-pro": {
      "command": "node",
      "args": ["/绝对路径/to/knotie-ai-mcp/build/index.js"]
    }
  }
}

注意： 将 /绝对路径/to/knotie-ai-mcp 替换为您实际克隆仓库的位置。

为什么是 index.js？ TypeScript 源代码（src/index.ts）在构建过程中编译为 JavaScript（build/index.js）。Node.js 运行编译后的 JavaScript 文件。

4. 重启 Claude Desktop

完全重启 Claude Desktop 以加载新的 MCP 服务器。

🎯 可用工具

系统工具

get-capabilities：获取系统能力和可用特性
get-health：检查 API 健康状态

客户管理

create-customer：创建新客户账户
- email（必需）：客户的电子邮件地址
- businessName（必需）：客户的公司名称
- contactName（可选）：主要联系人姓名
- phone（可选）：联系电话号码
- subscriptionTier（可选）：starter, professional, 或 enterprise
enable-portal-access：为客户启用门户访问
- customerEmail（必需）：客户的电子邮件地址
- sendWelcomeEmail（可选）：发送欢迎邮件（默认：true）
reset-customer-password：重置客户的密码
- customerEmail（必需）：客户的电子邮件地址
- sendEmail（可选）：发送密码重置邮件（默认：true）

代理管理

map-agent：将 AI 代理映射到客户
- customerEmail（必需）：客户的电子邮件地址
- agentId（必需）：来自 AI 平台的代理 ID
- platform（必需）：retell, vapi, elevenlabs, 或 gohighlevel
- profitMultiplier（可选）：利润倍数 1.0-10.0（默认：1.5）
- agentName（可选）：代理的自定义名称
update-agent：更新代理配置
- customerEmail（必需）：客户的电子邮件地址
- agentId（必需）：要更新的代理 ID
- profitMultiplier（可选）：新的利润倍数
- agentName（可选）：新的代理名称
- isActive（可选）：启用/禁用代理
unmap-agent：从客户处移除代理映射
- customerEmail（必需）：客户的电子邮件地址
- agentId（必需）：要取消映射的代理 ID

💡 使用示例

在 Claude Desktop 中

一旦配置好，您可以在 Claude Desktop 中使用自然语言命令：

"创建一个新客户，电子邮件为 john@example.com，公司名称为 'John's Restaurant'"

"将 Retell 代理 ID 'agent_123' 映射到客户 john@example.com，并设置 2.0 利润倍数"

"为客户 john@example.com 启用门户访问并发送欢迎邮件"

"检查 Knotie AI Pro API 的健康状态"

命令行测试

直接测试服务器：

# 测试服务器
npm run dev

# 或如果已全局安装
knotie-ai-mcp

🔒 安全性

本地配置：API 密钥存储在本地且从未传输给第三方
安全通信：所有 API 调用都使用带有适当身份验证的 HTTPS
合作伙伴验证：每个请求都包括合作伙伴电子邮件验证
无数据存储：MCP 服务器不存储任何客户或代理数据

🐛 故障排除

服务器未显示在 Claude Desktop 中

检查您的 claude_desktop_config.json 语法
确保服务器路径正确
完全重启 Claude Desktop
检查 Claude 的日志：~/Library/Logs/Claude/mcp*.log

配置错误

验证您的 API 密钥是否正确
确保您的合作伙伴电子邮件与您的账户匹配
检查配置文件是否位于受支持的位置
验证配置文件中的 JSON 语法

API 连接问题

重要提示：MCP 服务器连接到 分析服务，而不是主 Knotie AI Pro 网站。

正确的基础 URL：

生产环境：https://analytics.knotie-ai.pro
开发环境：http://localhost:8000（如果在本地运行分析服务）

常见问题：

404 Not Found：使用了错误的基础 URL（应为 analytics.knotie-ai.pro，而非 knotie-ai.pro）
连接被拒绝：分析服务可能已关闭或 URL 错误
401 Unauthorized：无效的 API 密钥或合作伙伴电子邮件
403 Forbidden：有效凭证但权限不足

调试步骤：

测试您的互联网连接
验证基础 URL 是否指向分析服务
检查您的 API 密钥是否有必要的权限
确保您的合作伙伴账户处于活动状态

尝试手动连接到健康端点：

curl -H "X-API-Key: your-api-key" \
     -H "X-Partner-Email: your-email@example.com" \
     https://analytics.knotie-ai.pro/health

📚 文档

🤝 贡献

欢迎贡献！请随时提交拉取请求。

📄 许可

MIT 许可证 - 详情见 LICENSE 文件。

🆘 支持

由 Knotie AI Pro 团队制作 ❤️