AI导哈

macOS系统访问工具

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

  • by caelinsutch
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 caelinsutch/local-mac-tools

使用说明

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):

{
  "mcpServers": {
    "macos-tools": {
      "command": "npx",
      "args": ["-y", "@macos-tools/mcp-server"]
    }
  }
}

促进地方发展

# 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数据库可能需要完全磁盘访问权限

发展

# 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

相关 MCP