iMCP 使用说明
项目简介
iMCP 是一款 macOS 应用程序,它充当 Model Context Protocol (MCP) 服务器,旨在桥接您的个人数字生活与人工智能应用。通过 iMCP,您可以授权 AI 客户端(如 Claude Desktop)安全访问您的日历、联系人、消息等个人数据,从而实现更智能、更个性化的 AI 交互体验。iMCP 自身不收集或存储任何用户数据,所有数据访问均在用户授权和控制下进行。
主要功能点
- 日历访问: 查看和管理日历事件,包括创建新事件。
- 联系人访问: 访问个人联系人信息,并支持通过姓名、电话号码或电子邮件地址搜索联系人。
- 位置信息访问: 获取当前位置数据,并在地址和地理坐标之间进行转换。
- 消息记录访问: 访问与特定参与者的消息历史记录(iMessage),可自定义日期范围。
- 提醒事项访问: 查看和创建提醒事项,可自定义截止日期、优先级和提醒。
- 天气信息访问: 获取任何地点的当前天气状况,包括温度、风速和天气状况。
安装步骤
- 下载 iMCP 应用: 访问 https://iMCP.app/download 下载适用于 macOS 15.3 或更高版本的 iMCP 应用程序。
- 打开 iMCP 应用: 下载完成后,打开 iMCP.app。应用启动后,您将在菜单栏中看到 iMCP 的图标 <img style="display: inline" width="20" height="16" src="/Assets/icon.svg" alt="iMCP Icon" />。
服务器配置
iMCP 主要设计为与 MCP 客户端配合使用,特别是 Claude Desktop。以下是针对 Claude Desktop 的服务器配置方法:
自动配置 (推荐)
- 打开 Claude Desktop 设置: 启动 Claude Desktop 应用,进入 “Settings... (⌘,)” 设置界面。
- 进入开发者设置: 在设置侧边栏中点击 “Developer”。
- 点击 "Configure Claude Desktop": 在 iMCP 菜单栏图标 <img style="display: inline" width="20" height="16" src="/Assets/icon.svg" alt="iMCP Icon" /> 的下拉菜单中,选择 “Configure Claude Desktop” 选项。iMCP 将自动配置 Claude Desktop 的 'claude_desktop_config.json' 文件,添加或更新 MCP 服务器配置以使用 iMCP 服务器。
手动配置
- 复制服务器命令: 在 iMCP 菜单栏图标 <img style="display: inline" width="20" height="16" src="/Assets/icon.svg" alt="iMCP Icon" /> 的下拉菜单中,选择 “Copy server command to clipboard” 选项。
- 编辑 Claude Desktop 配置文件: 打开 Claude Desktop 的配置文件 '~/Library/Application Support/Claude/claude_desktop_config.json'。如果文件不存在,请先在 Claude Desktop 设置的开发者选项中点击 "Edit Config" 创建。
- 添加 MCP 服务器配置: 在 'claude_desktop_config.json' 文件中,将以下 JSON 代码添加到 'mcpServers' 字段中(如果 'mcpServers' 字段不存在则创建),并将 '{paste iMCP server command}' 替换为您从剪贴板复制的 iMCP 服务器命令。
{ "mcpServers" : { "iMCP" : { "command" : "{paste iMCP server command}" // 这里粘贴 iMCP 复制的服务器命令 } } }
配置参数说明:
- 'server name': 'iMCP' - MCP 服务器的名称,在 Claude Desktop 中显示为工具来源。
- 'command': '{paste iMCP server command}' - 关键参数,MCP 服务器的启动命令,由 iMCP 应用程序提供,指向 iMCP 应用内集成的 'imcp-server' 命令行可执行文件。此命令包含了运行 MCP 服务器所需的所有路径和参数。 请务必使用 iMCP 应用程序提供的命令,手动修改可能导致连接失败。
- 'args': 此配置中 'args' 字段通常为空数组 '[]',因为 iMCP 服务器的运行参数已经包含在 'command' 命令中。
基本使用方法
- 激活服务: 在 iMCP 菜单栏图标的下拉菜单中,点击您想要启用的服务图标(例如日历、联系人等)。系统会弹出 macOS 权限对话框,请求访问您的个人数据。请根据需要点击 “Allow Full Access” 授权 iMCP 访问相应的服务。
- 连接 Claude Desktop: 按照服务器配置步骤配置 Claude Desktop 并重启应用。首次连接时,Claude Desktop 会弹出对话框请求批准与 iMCP 的连接,请点击批准。
- 使用工具: 连接成功后,在 Claude Desktop 的聊天输入框右下角会显示工具图标 🔨 和可用工具数量(例如 🔨12)。点击该图标可以查看 iMCP 提供的工具列表。现在您可以直接在 Claude Desktop 中向 Claude 提出需要访问个人数据的问题,例如 “How's the weather where I am?”,Claude 将自动调用 iMCP 提供的工具获取信息并给出回答。
注意:
- iMCP 依赖于 macOS 系统权限管理,请确保在弹出的权限对话框中正确授权 iMCP 访问您希望使用的服务。
- iMCP 作为一个本地 MCP 服务器运行,需要保持 iMCP 应用程序处于运行状态才能为 MCP 客户端提供服务。
信息
分类
桌面与硬件