Python Apple MCP (Model Context Protocol)

Python Apple MCP (Model Context Protocol)

site icon
2025.04.03 4
Python联系人管理笔记管理邮件管理消息管理提醒管理日历管理地图服务交流协作日程管理位置服务
Python Apple MCP (Model Context Protocol) 是一个基于Python实现的服务器,用于处理与macOS应用程序(如联系人、笔记、邮件、消息、提醒、日历和地图)的交互。它通过FastMCP提供异步操作、全面的错误处理、类型安全的接口以及模块化设计,便于扩展。
View on GitHub

Overview

基本能力

产品定位

Python Apple MCP 是一个用于与macOS原生应用程序交互的工具,旨在提高开发效率,简化与macOS应用程序的集成。

核心功能

  • 通过AppleScript与macOS原生应用程序交互
  • 异步操作以提高性能
  • 全面的错误处理
  • 使用Pydantic模型的类型安全接口
  • 模块化设计,便于扩展

适用场景

  • 自动化联系人管理
  • 笔记创建和搜索
  • 邮件发送和搜索
  • 消息发送和读取
  • 提醒创建和管理
  • 日历事件管理
  • 地图位置搜索和导航

工具列表

  • Contacts Module: 查找、创建和管理联系人
  • Notes Module: 查找、创建和管理笔记
  • Mail Module: 发送、搜索和管理邮件
  • Messages Module: 发送、读取和计划消息
  • Reminders Module: 创建、搜索和管理提醒
  • Calendar Module: 创建、搜索和管理日历事件
  • Maps Module: 搜索位置、获取方向和保存位置

常见问题解答

  • 如何安装依赖?
  • 使用pip install -r requirements.txt安装依赖
  • 如何运行测试?
  • 使用pytest运行测试套件
  • 如何贡献代码?
  • Fork仓库,创建特性分支,提交更改并创建Pull Request

使用教程

使用依赖

  1. 克隆仓库:
git clone https://github.com/jxnl/python-apple-mcp.git
cd python-apple-mcp
  1. 创建虚拟环境:
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. 安装依赖:
pip install -r requirements.txt
  1. 安装测试依赖(可选):
pip install -r requirements-test.txt

安装教程

  1. 完成上述依赖安装步骤
  2. 运行示例代码:
from apple_mcp import FastMCP, Context

# Initialize FastMCP server
mcp = FastMCP("Apple MCP")

# Use the tools
@mcp.tool()
def find_contact(name: str) -> List[Contact]:
    """Search for contacts by name"""
    # Implementation here
    pass

# Run the server
if __name__ == "__main__":
    mcp.run()

调试方式

  1. 运行测试:
pytest
  1. 运行特定测试文件:
pytest tests/test_contacts.py
  1. 运行测试并生成覆盖率报告:
pytest --cov=utils tests/

许可证

该项目遵循 MIT 开源许可条款。