MCP的macOS联系人
将您的macOS联系人应用程序连接到Claude Desktop和Cursor等AI助手。使用本地联系人数据直接通过对话搜索、查看和管理您的联系人。
这有什么作用
- 搜索您的联系人 按姓名或公司
- 查看完整的联系方式 包括电子邮件、电话和社交链接
- 添加新联系人 带有笔记、社交媒体资料（领英、推特、GitHub等）
- 更新现有联系人 有了新的信息和社交联系
- 浏览最近的联系人 查看您添加或修改了谁
适用于您本地的macOS联系人应用程序，无需与外部服务同步。
安装说明
1.获取代码
git clone https://github.com/jcontini/macos-contacts-mcp.git
cd macos-contacts-mcp
npm install && npm run build2.添加到您的AI助手
将此配置添加到MCP客户端：
{
"mcpServers": {
"macos-contacts": {
"command": "node",
"args": ["/path/to/your/macos-contacts-mcp/build/index.js"]
}
}
}3.授予权限
当您首次使用联系人功能时，macOS会请求权限：
- 联系人访问：允许您的AI助手访问联系人
- 自动化权限：允许应用程序控制联系人
您还可以在中手动设置这些 系统设置→ 隐私和安全→ 联系人 和 自动化.
4.重新启动助手
关闭并重新打开AI助手以加载新连接。
使用它
设置完成后，您可以向您的AI助手询问以下问题：
- “在谷歌上查找我的联系人”
- “显示John的联系方式和社交链接”
- “在Jane Smith的LinkedIn个人资料中添加一个新联系人”
- “本周我添加了谁的联系人？”
- “更新John的职位并添加他的GitHub个人资料”
社交媒体支持
您可以存储和管理联系人的社交媒体资料：
- LinkedIn个人资料
- 推特/X账户
- GitHub配置文件
- 脸书个人资料
- 任何其他网站或社交链接
故障排除
“未找到联系人”错误： 确保您的联系人应用程序中存在与您正在搜索的姓名完全一致的联系人。
权限错误： 检查系统设置→ 隐私和安全，并确保您的AI助手可以访问联系人和自动化。
服务器无法启动： 确保你跑了 npm install && npm run build 配置中的路径是正确的。
需求
- macOS与联系人应用程序
- Node.js（任何最新版本）
- 兼容MCP的人工智能助手
适用于Claude Desktop、Cursor和支持模型上下文协议的任何其他应用程序。
未来计划
我们正在研究更简单的分发方法，以消除手动安装的需要：
桌面扩展（.dxt）
Claude Desktop现在支持通过桌面扩展进行一键安装。我们计划将此服务器打包为 .dxt 文件用于：
- 无需手动设置 -双击安装
- 无依赖关系 -Claude Desktop包含Node.js运行时
- 自动更新 -无缝版本管理
- 整理目录 -通过Claude Desktop的扩展市场发现
NPM分布
对于喜欢包管理器的开发人员：
- NPX支持:
npx macos-contacts-mcp用于即时使用 - 全球安装:
npm install -g macos-contacts-mcp - 版本管理：通过npm轻松更新
MCP目录列表
我们将提交到主要的MCP目录以获得更好的可发现性：
- Glama.ai公司 -具有质量评级的全面MCP市场
- PulseMCP 的 -使用5000多台服务器和过滤器清理目录
- McpServers.org -社区驱动的MCP服务器注册表
- 出色的MCP服务器 -基于GitHub的策划列表
这些改进将使安装变得像单击或命令一样简单，同时保持强大的本地联系人管理功能。
TODO:LLM友好型改进
根据LLM的实际使用情况，以下改进将使该MCP更加稳健：
优雅的错误处理
- 问题：AppleScript语法错误不会向LLM提供有关出错原因的有用反馈
- 解决方案：捕获AppleScript错误并将其转换为可操作的错误消息
- 为什么：更好的错误消息有助于LLM理解并使用更正的输入重试