项目简介

Dex MCP 服务器是基于 Model Context Protocol (MCP) 实现的应用后端，旨在通过标准化的协议，让大型语言模型 (LLM) 客户端能够与 Dex 联系人关系管理平台进行交互。它将 Dex 的数据和功能封装为 MCP 的工具（Tools），使得 AI Agents 可以通过调用这些工具来查询、修改联系人、笔记和提醒信息，从而增强 AI 在人际关系管理场景中的上下文理解和操作能力。

主要功能点

• 联系人管理: 通过 AI 指令创建、读取、更新和删除联系人。支持按姓名、公司、邮箱搜索联系人，并获取联系人的详细信息，包括邮件和电话。
• 笔记管理: 为联系人添加、更新、删除和搜索笔记。笔记作为时间线项目存储，方便记录与联系人的互动细节。
• 提醒管理: 为联系人设置、更新、删除和完成提醒。支持按文本内容搜索提醒，并能处理设置重复提醒的需求。

安装步骤

1. 确保您的系统上已安装 Node.js (版本 18 或更高)。
2. 拥有一个 Dex API 账号并获取您的个人 API Key。
3. 使用 Git 克隆本项目的代码到您选择的目录。
4. 进入项目目录，运行 'npm install' 命令安装所有必要的依赖库。
5. 编辑项目的源代码文件 ('src/index.ts')，将示例的 API Key 替换为您自己的 Dex API Key。
6. 运行 'npm run build' 命令编译 TypeScript 代码生成可执行的 JavaScript 文件。

服务器配置

该服务器通常作为外部服务集成到支持 MCP 协议的 LLM 应用（如 AnythingLLM）中。您需要在 LLM 应用的 MCP 服务器配置界面或文件中，指定启动该服务器的命令和参数。关键的配置信息通常包括：

• 服务器名称: 为该服务器指定一个在客户端中唯一的名称（例如 'dex-mcp'）。
• 启动命令 (command): 指定 Node.js 可执行文件的完整路径（例如 '/usr/local/bin/node' 或 '/path/to/your/node'）。
• 启动参数 (args): 提供一个参数列表，其中必须包含编译后服务器主脚本的路径（例如 '["/path/to/your/dex-mcp-server/dist/index.js"]'）。
• 环境变量 (env): 可选，用于设置任何必要的环境变量。

请查阅您的 LLM 客户端文档，以了解具体的配置格式和步骤，并根据您实际安装 Dex MCP 服务器的路径进行调整。

基本使用方法

配置完成后，您的 LLM 客户端将能通过该服务器访问 Dex 的功能。您可以尝试使用自然语言向 LLM 发出指令，例如：

• “在我的联系人中添加一个新条目：姓名是王小明，公司是创新科技。”
• “帮我查找所有提到‘项目进度’的笔记。”
• “设置一个提醒，下周二提醒我给李华发邮件。”
• “更新 ID 为 [某个联系人ID] 的联系人信息，将他的职位改为‘高级经理’。”
• “显示所有未完成的提醒事项列表。”

LLM 将通过调用相应的 MCP 工具来执行这些指令。