Loops MCP Server

Loops.so MCP服务器

用于与Loops.so电子邮件平台API集成的模型上下文协议（MCP）服务器。此服务器提供用于通过Claude Desktop和其他MCP兼容客户端管理联系人、发送事件和处理事务性电子邮件的工具。

特性

服务器实现以下Loops.so API端点作为MCP工具：

• 联系人管理

- create_contact -向您的受众添加新联系人 - update_contact -更新现有联系信息 - find_contact -通过电子邮件或用户ID搜索联系人 - delete_contact -从您的受众中删除联系人

• 电子邮件操作

- send_event -循环触发自动电子邮件 - send_transactional_email -立即发送交易电子邮件

• 数据检索

- get_mailing_lists -列出您的所有邮件列表 - get_custom_fields -获取所有自定义联系人属性

安装

选项1：从npm安装（推荐）

npm install -g loops-mcp-server

选项2：从源代码安装

# Clone or download the repository
git clone 
cd loops-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

安装说明

1.获取您的循环API密钥

1. 登录到您的 Loops.so帐户
2. 导航至 设置→ API
3. 复制API密钥

2.配置您的MCP客户端

选择您的编辑器/平台，并按照以下配置步骤进行操作。

选项A：使用npx（推荐）

这将自动下载并运行最新版本：

{
  "mcpServers": {
    "loops": {
      "command": "npx",
      "args": ["-y", "loops-mcp-server"],
      "env": {
        "LOOPS_API_KEY": "your-loops-api-key-here"
      }
    }
  }
}

选项B：全局安装

如果您希望先全局安装：

npm install -g loops-mcp-server

然后在config中使用：

{
  "mcpServers": {
    "loops": {
      "command": "loops-mcp-server",
      "env": {
        "LOOPS_API_KEY": "your-loops-api-key-here"
      }
    }
  }
}

______________________________________________________________________

编辑器特定配置

克劳德桌面版

配置文件位置：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%/Claude/claude_desktop_config.json
• Linux： ~/.config/Claude/claude_desktop_config.json

配置：

{
  "mcpServers": {
    "loops": {
      "command": "npx",
      "args": ["-y", "loops-mcp-server"],
      "env": {
        "LOOPS_API_KEY": "your-loops-api-key-here"
      }
    }
  }
}

配置后： 完全退出并重新启动Claude Desktop。

______________________________________________________________________

光标IDE

配置文件位置：

• macOS： ~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• 窗户： %APPDATA%/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Linux： ~/.config/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

配置：

{
  "mcpServers": {
    "loops": {
      "command": "npx",
      "args": ["-y", "loops-mcp-server"],
      "env": {
        "LOOPS_API_KEY": "your-loops-api-key-here"
      }
    }
  }
}

备选方案： Cursor还可以通过以下方式支持MCP配置：

• 设置界面： Cmd/Ctrl + , → 搜索“MCP”
• 工作区设置： .cursor/mcp.json

配置后： 重新启动Cursor IDE。

______________________________________________________________________

风帆/Codeium

配置文件位置：

• macOS： ~/.codeium/windsurf/mcp_config.json
• 窗户： %APPDATA%/.codeium/windsurf/mcp_config.json
• Linux： ~/.config/.codeium/windsurf/mcp_config.json

配置：

{
  "mcpServers": {
    "loops": {
      "command": "npx",
      "args": ["-y", "loops-mcp-server"],
      "disabled": false,
      "env": {
        "LOOPS_API_KEY": "your-loops-api-key-here"
      }
    }
  }
}

配置后： 使用Windsurf的MCP设置UI中的刷新按钮或重新启动Windsurf。

______________________________________________________________________

VS代码（带MCP扩展）

先决条件：

• 安装VS代码的MCP扩展（例如。， modelcontextprotocol.vscode-mcp)

配置文件位置：

• 工作区： .vscode/mcp.json
• 用户：VS代码设置→ MCP配置

配置(.vscode/mcp.json):

{
  "mcpServers": {
    "loops": {
      "command": "npx",
      "args": ["-y", "loops-mcp-server"],
      "env": {
        "LOOPS_API_KEY": "your-loops-api-key-here"
      }
    }
  }
}

备选方案（设置UI）：

1. 打开VS代码设置(Cmd/Ctrl + ,)
2. 搜索“MCP”
3. 编辑MCP服务器配置
4. 添加循环服务器配置

配置后： 重新加载VS Code窗口或重新启动VS Code。

______________________________________________________________________

Continue.dev

配置文件位置：

• ~/.continue/config.json （或工作空间 .continue/config.json)

配置：

{
  "mcpServers": {
    "loops": {
      "command": "npx",
      "args": ["-y", "loops-mcp-server"],
      "env": {
        "LOOPS_API_KEY": "your-loops-api-key-here"
      }
    }
  }
}

配置后： 重新启动Continue.dev。

______________________________________________________________________

帮助

配置： 添加到助手配置文件（通常 ~/.aider.conf 或 aider.conf):

mcp:
  servers:
    loops:
      command: npx
      args: ["-y", "loops-mcp-server"]
      env:
        LOOPS_API_KEY: "your-loops-api-key-here"

配置后： 重新启动辅助装置。

______________________________________________________________________

Cline（VS代码扩展）

配置文件位置：

• VS代码设置或工作区 .cline/mcp.json

配置：

{
  "mcpServers": {
    "loops": {
      "command": "npx",
      "args": ["-y", "loops-mcp-server"],
      "env": {
        "LOOPS_API_KEY": "your-loops-api-key-here"
      }
    }
  }
}

______________________________________________________________________

通用MCP客户端配置

如果您使用的是其他兼容MCP的客户端，请使用以下标准配置：

{
  "mcpServers": {
    "loops": {
      "command": "npx",
      "args": ["-y", "loops-mcp-server"],
      "env": {
        "LOOPS_API_KEY": "your-loops-api-key-here"
      }
    }
  }
}

要点：

• 替换 your-loops-api-key-here 使用您的实际Loops API密钥
• 这 -y npx中的标志自动确认软件包安装
• 确保Node.js 18+已安装并在您的PATH中
• 配置更改后重新启动编辑器/客户端

发展

以开发模式运行

对于自动重新加载的开发，请使用：

npm run dev

为生产而建

npm run build

运行内置服务器

npm start

使用示例

配置后，您可以通过Claude Desktop与Loops API交互：

• “使用电子邮件创建联系人test@example.com"
• “通过电子邮件查找联系人test@example.com"
• “向发送一个名为“欢迎”的活动test@example.com"
• “显示我的所有邮件列表”
• “更新联系人test@example.com取消订阅”
• “删除带有电子邮件的联系人test@example.com"

API费率限制

Loops.so的基线速率限制为每个团队每秒10个请求。服务器包括对速率限制响应的适当错误处理（429）。

错误处理

服务器包括全面的错误处理，如果API调用失败，将返回有意义的错误消息。所有错误都已正确格式化并返回给MCP客户端。

安全

• 永远不要承诺你的 LOOPS_API_KEY 到版本控制
• API键仅从环境变量中读取
• 服务器按照Loops.so的要求使用承载令牌身份验证

故障排除

常见问题

“找不到命令”或“在$PATH中找不到可执行文件”

• 确保已安装Node.js 18+： node --version
• 如果使用npx，请确保npm在您的PATH中
• 尝试使用完整路径： "command": "node", "args": ["-m", "loops-mcp-server"]

“LOOPS_API_KEY环境变量是必需的”

• 验证配置文件中是否正确设置了API密钥
• 检查环境变量名称中的拼写错误（必须是 LOOPS_API_KEY)
• 确保配置文件JSON有效

服务器未连接

• 完全重新启动编辑器/客户端
• 检查编辑器日志中的错误消息
• 在验证您的API密钥https://app.loops.so → 设置→ API
• 手动测试服务器： LOOPS_API_KEY=test npx -y loops-mcp-server （将出错，但确认它正在运行）

连接超时

• 检查您的互联网连接（npx下载该软件包）
• 请先尝试全局安装： npm install -g loops-mcp-server
• 检查防火墙/代理设置

获取帮助

• 文档：
• 问题： 报告Bug
• 循环.so API文档： api参考

测试

有关全面的测试说明，请参阅 测试指南.md.

快速测试：

export LOOPS_API_KEY="your-api-key"
node test-mcp-client.js

许可证

ISC