Local Mac Tools

MCPAI代理

提供方 caelinsutch

AI代理 未标注 无需鉴权 社区 / 第三方 Claude DesktopClaude

一个Model Context Protocol (MCP)服务器,为AI助手如Claude提供安全、本地的macOS系统数据访问功能,包括查询联系人、发送iMessage以及与macOS应用交互。

一句话选型结论

按资料字段整理

Local Mac Tools 属于AI代理类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

AI助手TypeScript本地部署macOS集成本地数据处理隐私保护自然语言交互

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Local Mac Tools当前 未标注 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方caelinsutch上游标注的维护方 caelinsutch
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

3.6 KB
来自项目仓库与上游目录的原文,未做删改

macOS工具MCP服务器

一个模型上下文协议(MCP)服务器,为Claude等AI助手提供对macOS系统数据的安全本地访问。查询联系人、发送iMessage以及直接通过自然语言与macOS应用程序交互——所有这些都在您的计算机上本地运行。

概述

此MCP服务器使AI助手能够通过标准化协议与macOS系统功能进行交互:

  • 联系人集成 -从macOS Contacts/AddressBook中搜索和检索联系人信息
  • iMessage访问 -查询iMessage对话、消息和附件(SDK就绪)
  • AppleScript/OSA集成 -执行AppleScript命令进行常规macOS应用程序交互
  • 隐私第一 -所有数据都保留在您的机器上;无需云处理

什么是MCP?

模型上下文协议(MCP) 是一个开放标准,使人工智能助手能够安全地连接到外部数据源和工具。此服务器实现了MCP,使Claude和其他兼容的AI助手能够控制对macOS系统数据的访问。

安装

适用于克劳德桌面

添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json):```json
{
"mcpServers": {
"macos-tools": {
"command": "npx",
"args": ["-y", "@macos-tools/mcp-server"]
}
}
}


### 促进地方发展```bash
# Install dependencies
pnpm install

# Run the MCP server
pnpm --filter @macos-tools/mcp-server dev

# The server will start on http://localhost:3000
# Use the MCP Inspector to test: pnpm --filter @macos-tools/mcp-server inspect

可用工具

contacts_search

按姓名或电话号码搜索您的macOS联系人。

参数:

  • name (可选):按联系人姓名搜索
  • phone (可选):按电话号码搜索

例子:```
"Find the phone number for John Doe"
"Search for contact with phone number 555-0123"


## 包裹

此monorepo包含以下包:

### `@macos-tools/mcp-server` (应用程序/api)

向AI助手公开macOS功能的主MCP服务器。使用Hono和MCP SDK构建。

### `@macos-tools/contacts-sdk`

用于查询macOS联系人数据的TypeScript SDK。从本地地址簿数据库中检索联系人信息、电话号码、电子邮件和其他详细信息。

### `@macos-tools/imessage-sdk`

用于查询iMessage数据的TypeScript SDK。从本地iMessage数据库访问消息、对话、联系人和附件。

### `@macos-tools/logger`

所有软件包都使用基于Winston的共享日志工具。

## 需求

- **操作系统**:仅限macOS(达尔文)
- **节点**:>=14.0.0(>=22.0.0建议开发)
- **包管理器**:pnpm 10.20.0(用于开发)
- **权限**:访问联系人和iMessage数据库可能需要完全磁盘访问权限

## 发展```bash
# Install dependencies
pnpm install

# Build all packages
pnpm run build

# Run the MCP server in watch mode
pnpm --filter @macos-tools/mcp-server dev

# Type checking
pnpm run check-types

# Lint
pnpm run lint

# Format code
pnpm run format

项目结构```

├── apps/
│ └── api/ # MCP server (published as @macos-tools/mcp-server)
├── packages/
│ ├── contacts-sdk/ # macOS Contacts SDK
│ ├── imessage-sdk/ # iMessage SDK
│ ├── logger/ # Shared logging utility
│ └── typescript-config/ # Shared TypeScript configuration
└── package.json # Monorepo root
```

路线图

  • [x] 联系人搜索功能
  • [x] 基本MCP服务器实现
  • [x] iMessage查询工具(SDK已完成,MCP集成待定)
  • []通过MCP发送iMessage
  • []常规AppleScript/OSA命令执行
  • []Notes应用程序集成

许可证

GNUv3

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Local Mac Tools 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Local Mac Tools 怎么在 Claude Desktop、Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Local Mac Tools 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Local Mac Tools 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Local Mac Tools 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Local Mac Tools 能提供哪些能力?

资料显示能力标签包括 隐私保护、TypeScript、Claude、自然语言交互。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。