🚀 瞬时配置指南
本指南为您提供 Instantly-MCP 项目的安装、开发设置及贡献相关的详细说明，助您快速上手该项目。
🚀 快速开始
立即安装说明
按照以下步骤完成项目的安装与运行：
- 克隆仓库：
git clone https://github.com/bcharleson/Instantly-MCP.git cd Instantly-MCP - 安装依赖项：
npm install - 创建
.env文件，在根目录下添加您的 Instantly API 密钥：INSTANTLY_API_KEY=your_api_key_here⚠️ 重要提示
请勿将
.env文件或 API 密钥提交到版本控制系统。.gitignore已包含.env文件以防止意外提交。 - 构建项目：
npm run build - 运行服务器：
node dist/index.js
开发设置
若您想为该项目做出贡献或在本地进行开发，可按以下步骤操作：
- 克隆仓库：
git clone https://github.com/bcharleson/Instantly-MCP.git cd Instantly-MCP - 安装依赖项：
npm install - 创建
.env文件，在根目录下添加您的 Instantly API 密钥：INSTANTLY_API_KEY=your_api_key_here⚠️ 重要提示
请勿将
.env文件或 API 密钥提交到版本控制系统。.gitignore已包含.env文件以防止意外提交。 - 构建项目：
npm run build - 运行服务器：
node dist/index.js
✨ 贡献指南
欢迎您为项目贡献力量！若您想做出贡献，请按以下步骤操作：
- Fork 仓库
- 创建新功能分支（
git checkout -b feature/amazing-feature） - 进行修改
- 提交更改（
git commit -m 'Add some amazing feature'） - 推送分支（
git push origin feature/amazing-feature） - 创建 Pull Request
在提交 Pull Request 前，请确认以下事项：
- 是否为新增功能创建了测试？
- 所有测试是否都已通过？
- 是否在必要时更新了文档？
📚 工具的测试状况
此 MCP 服务器实现的所有工具都已确认能与 Instantly API v2 正常配合使用。以下表格总结了各工具的测试情况：
| # | 工具名 | 状态 | 备注 |
|---|---|---|---|
| 1 | instantly_list_campaigns |
✅ 已认证 | 成功显示活动列表，并支持分页功能 |
| 2 | instantly_list_leads |
❌ 未正常工作 | 获取潜在客户列表时出现「无效电子邮件地址」API 错误 |
| 3 | instantly_delete_lead |
✅ 已认证 | 可通过 ID 或电子邮件地址成功删除潜在客户 |
| 4 | instantly_create_lead |
✅ 已认证 | 可创建新的潜在客户，并能使用正确的数据正常工作 |
| 5 | instantly_get_lead |
✅ 已认证 | 可通过 ID 成功获取潜在客户的详细信息 |
| 6 | instantly_update_lead |
✅ 已认证 | 可更新现有潜在客户的信息 |
| 7 | instantly_list_accounts |
✅ 已认证 | 成功列出所有电子邮件账户，并显示统计信息 |
| 8 | instantly_get_account |
✅ 已认证 | 成功获取详细的账户信息 |
| 9 | instantly_test_account_vitals |
✅ 已认证 | 成功获取账户的健康状态 |