Dex MCP Server

Dex MCP服务器


v1.0.0现已发布！ - 看 发布-注释.md 和 查看亮点和升级信息。 - 如何升级： 1. 提取最新代码： git pull --rebase origin main 1. 确保您的 .env 文件存在并且包含有效的 DEX_API_KEY. 1. 使用 kill-dex-mcp-server.sh 如果需要，在代理启动之前编写脚本。 1. 看 copilot-instructions.md 了解代理/CLI的使用和最佳实践。

模型上下文协议（MCP）服务器，通过Dex API为人工智能代理提供全面的联系关系管理功能。

特性

🚀 联系人管理

• 创建、读取、更新、删除 详细联系方式
• 搜索联系人 按姓名、电子邮件或公司
• 全面的联系方式：姓名、公司、职位、描述、电子邮件、电话号码

📝 笔记管理

• 联系人链接笔记 存储为时间线项目
• 创建、更新、删除 任何联系的注意事项
• 搜索笔记 按所有联系人的内容
• 分页支持 用于大额纸币收藏

⏰ 提醒管理

• 设置提醒 链接到特定联系人
• 完成、更新、删除 根据需要提醒
• 搜索提醒 按文本内容
• 经常性支持 用于定期随访
• 到期日期跟踪 具有适当的日期格式

安装

先决条件

• Node.js 18或更高版本
• Dex API帐户和API密钥

设置

1. 克隆此存储库：

git clone https://github.com/alpabon73/dex-mcp-server.git
cd dex-mcp-server

1. 安装依赖项：

npm install

1. 在中配置您的Dex API密钥 src/index.ts:

const API_KEY = 'your-dex-api-key-here';

1. 构建服务器：

npm run build

环境变量

此项目需要Dex API密钥。 永远不要将真正的API密钥提交到公共存储库。

1. 复制 .env.example 向 .env:

   cp .env.example .env

1. 编辑 .env 并设置您真正的Dex API密钥：

   DEX_API_KEY=your-dex-api-key-here

1. 除非满足以下条件，否则服务器将无法启动 DEX_API_KEY 在您的环境中设置或 .env 文件。

.env已经在.gitignore中，永远不会被提交。

用法

独立使用

npm start

与任何LLM

添加到MCP服务器配置中：

{
  "servers": {
    "dex-mcp": {
      "command": "/usr/local/bin/node",
      "args": ["/path/to/dex-mcp-server/dist/index.js"],
      "env": {}
    }
  }
}

可用工具

接触工具（6）

• get_contacts -使用分页检索联系人
• get_contact_by_id -获取具体联系方式
• search_contacts -按姓名/公司/电子邮件搜索
• create_contact -添加新联系人
• update_contact -修改现有联系人
• delete_contact -删除联系人

笔记工具（6）

• get_notes_by_contact -获取联系人的所有笔记
• get_all_notes -按页码检索所有笔记
• search_notes -按内容搜索笔记
• create_note -向联系人添加备注
• update_note -修改现有笔记
• delete_note -删除笔记

提醒工具（6）

• get_reminders_by_contact -获取联系人提醒
• get_all_reminders -使用分页检索所有提醒
• search_reminders -按文本搜索提醒
• create_reminder -设置新提醒
• update_reminder -修改现有提醒
• complete_reminder -将提醒标记为已完成
• delete_reminder -删除提醒

允许用于笔记的会议类型

创建备注时，可以使用显示名称或Dex API枚举值指定会议类型。下表显示了可接受的值：

您可以使用上述任何显示名称（不区分大小写，允许使用空格和斜线）或确切的枚举值。系统将自动将您的输入映射到正确的Dex API值。

示例用例

• “将TechCorp的John Smith添加为新联系人”
• “设置一个提醒，以便下周与Sarah联系”
• “搜索有关ABC项目的所有注释”
• “将Mike的职位升级为高级工程师”
• “显示本月所有待处理的提醒”
• “创建关于今天与客户会面的笔记”

发展

脚本

• npm run build -编译TypeScript
• npm run dev -使用ts节点运行以进行开发
• npm run watch -观看模式编译
• npm start -运行已编译的服务器

建筑

• TypeScript 用于类型安全
• 萨德 用于模式验证
• 阿西奥斯 用于向Dex API发送HTTP请求
• MCP-SDK 用于协议实施

API集成

此服务器与Dex API集成使用：

• GraphQL端点: https://api.getdex.com/v1/graphql
• 时间线项目 用于纸币存储
• 提醒表 带接触接头
• 正确的分页 以及搜索功能

代码质量和CI

此项目使用 TypeScript 为了类型安全和 ESLint 用于代码过滤。所有代码都会自动检查CI中的类型错误和lint问题（请参阅 .github/workflows/ci.yml).

• 在本地运行类型检查：

  npm run build # or npx tsc --noEmit

• 在本地运行过梁：

  npm run lint

所有拉取请求在合并之前都必须通过CI检查。

问题和公关模板

• Bug报告和功能请求使用GitHub问题模板以保持一致性。
• 所有拉取请求都使用PR模板来确保质量和文档。

安全与秘密

• 切勿提交机密或API密钥。 .env 被忽略，机密从环境变量中加载。
• 如果有秘密被提交，请遵循回购的历史清理协议（参见 scrub-git-history.sh).

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 如果适用，添加测试
5. 跑 npm run lint 和 npm run build 检查代码质量
6. 提交拉取请求

许可证

MIT许可证-有关详细信息，请参阅许可证文件

支持

关于以下问题：

• Dex API：检查 Dex文件
• MCP协议：参见 MCP规范
• 此服务器：在此存储库中打开一个问题

______________________________________________________________________

如何报告问题或做出贡献

• 发现错误或有功能请求？ 打开一个问题
• 想贡献吗？看 贡献.md 作为指导方针。
• 安全问题？看 安全.md 负责披露。
• 有关发行说明和升级信息，请参阅 发布-注释.md 和 更改日志.md.