Affinity MCP Server

MCPAI代理

提供方 sekharmalla

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

一个MCP协议服务器,允许AI助手通过自然语言完全控制macOS上的Affinity创意套件,实现专业设计软件的自动化操作。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

支持客户端

适用场景

AI自动化TypeScript本地部署创意设计工具macOS集成MCP协议专业设计软件控制

安装与配置

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

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后客户端会列出约 23 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

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

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

多步任务编排

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

自动化重复流程

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

选择建议

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

值得选的地方

  • 资料标注 23 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Affinity MCP Server当前 23 未标注 未标注 无 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代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方sekharmalla上游标注的维护方 sekharmalla
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

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

亲和MCP服务器

让AI在macOS上控制Affinity创意套件

上面的海报是用Affinity设计的,由Claude通过这个MCP服务器导出。


这是什么?

一 MCP(模型上下文协议) 服务器,让像克劳德这样的人工智能助手完全控制 亲和力 macOS上的创意套件。它通过自然语言弥合了人工智能和专业设计软件之间的差距——启动应用程序、导航菜单、绘制形状、应用过滤器、导出文件等等。

特性

  • 23工具 涵盖完整的Affinity工作流程
  • 统一亲和应用程序 支持(Canva的Affinity)
  • 菜单导航 --浏览并单击最多4级深度的任何菜单项
  • UI检查 --读取按钮、对话框、文本字段,并与它们进行交互
  • 鼠标和键盘 --单击、拖动、键入文本、发送快捷方式和按键代码
  • 截图 --捕获Affinity窗口以获得视觉反馈
  • 文档操作 --创建、打开、保存、导出、展平、旋转、翻转
  • 图层和过滤器 --添加图层、列出筛选器、导入宏

先决条件

  • macOS (使用AppleScript和系统事件)
  • Canva的亲和力 (v2——统一应用程序)
  • 包子 运行时(v1.0.0+)
  • 无障碍权限 --系统设置>隐私和安全>辅助功能-授予对终端应用程序和/或Claude Desktop的访问权限

快速开始```bash

Clone the repo

git clone https://github.com/sekharmalla/affinity-mcp-server.git
cd affinity-mcp-server

Install dependencies

bun install

Run the server

bun run start


## 作为Claude代码插件安装

开始使用Claude Code的最简单方法——一个命令,无需手动配置:```bash
claude plugin add /path/to/affinity-mcp-server

这会自动:

  • 注册MCP服务器(所有23个工具立即可用)
  • 安装 亲和力设计技巧 --工作流程指南,教Claude如何为实际设计任务编排工具(创建海报、导出文件、导航菜单等)

技能是关键的增值:MCP工具是低级原语(单击此处,键入此),但技能提供了高级工作流知识(如何创建海报、如何导出到网络、如何导航Affinity的UI模式)。

配置

将服务器添加到AI客户端的MCP配置中:

克劳德代码```bash

claude mcp add affinity-mcp-server bun run /path/to/affinity-mcp-server/index.ts


### 克劳德桌面版

添加 `~/Library/Application Support/Claude/claude_desktop_config.json`:```json
{
"mcpServers": {
"affinity-mcp-server": {
"command": "bun",
"args": ["run", "/path/to/affinity-mcp-server/index.ts"]
}
}
}

光标

添加 .cursor/mcp.json 在您的项目中:```json
{
"mcpServers": {
"affinity-mcp-server": {
"command": "bun",
"args": ["run", "/path/to/affinity-mcp-server/index.ts"]
}
}
}


### VS Code

添加 `.vscode/mcp.json` 在您的工作空间中:```json
{
"servers": {
"affinity-mcp-server": {
"command": "bun",
"args": ["run", "/path/to/affinity-mcp-server/index.ts"]
}
}
}

工具参考

应用生命周期

工具 说明
affinity_status 检查Affinity是否正在运行,列出打开的窗口
affinity_launch 启动Affinity(如果尚未运行)

文件操作

工具 说明
affinity_open_file 在Affinity中打开一个文件(图像、.af、.psd、.svg等)
affinity_new_document 创建新文档,可选择从上次预设中创建
affinity_save 保存或另存为当前文档
affinity_export 通过文件>导出导出(PNG、JPG、SVG、PDF等)导出
affinity_close_document 关闭当前文档

菜单系统

工具 说明
affinity_click_menu 按路径单击任何菜单项(最多4级深度)
affinity_get_menus 列出顶级菜单中的所有项目
affinity_get_submenu 在子菜单中列出项目

UI检查和交互

工具 说明
affinity_get_ui 检查前窗——按钮、文本字段、对话框
affinity_click_ui 按描述或标题单击UI元素

输入

工具 说明
affinity_keystroke 发送带有可选修饰符的按键
affinity_key_code 发送密钥代码(Escape、Return、箭头等)
affinity_type_text 在文本字段、对话框或文本工具中键入文本
affinity_mouse_action 在屏幕坐标处单击或拖动

绘图和工具

工具 说明
affinity_select_tool 选择工具(移动、笔、矩形、文本、画笔等)

文档操作

工具 说明
affinity_document_ops 压平、翻转、旋转、剪裁/松开画布
affinity_add_layer 添加图层(像素、遮罩、调整、填充等)
affinity_undo_redo 撤消或重做操作

过滤器和宏

工具 说明
affinity_filters 列出可用筛选器
affinity_run_macro 导入并运行.afmacro文件

捕捉

工具 说明
affinity_screenshot 截取Affinity窗口的屏幕截图

运作原理```

AI Client ──stdio──> MCP Server ──execSync──> osascript ──AppleScript──> System Events ──> Affinity


服务器通过stdio接收MCP工具调用,将其转换为AppleScript命令,并通过 `osascript`.System Events处理菜单导航、UI交互和键盘/鼠标输入。对于拖动操作,它使用Python的Quartz框架进行平滑坐标插值。

## 海报背后的故事

本自述顶部的海报不是由Affinity中的人设计的。它是由 **Claude使用此MCP服务器** --打开Affinity,创建文档,放置元素,设置文本样式,并导出最终的PNG。这是这个工具有效的最终证明:项目的营销材料是由项目本身制作的。

## 故障排除

### 可访问权限

服务器需要可访问性访问权限,以便通过系统事件控制亲和力。首选 **系统设置>隐私和安全>辅助功能** 并添加您的终端应用程序(terminal、iTerm2、Warp等)和/或Claude Desktop。

### 流程名称Quirk

Affinity的App Store版本注册为 `"Affinity Affinity Store"` 在系统事件中——不仅仅是 `"Affinity"`。这被硬编码为 `PROCESS_NAME` 在 `index.ts`。如果您有非App Store版本,则可能需要将其更改为 `"Affinity 2"` 或者不管你的版本报告什么。

要检查您的进程名称,请执行以下操作:```bash
osascript -e 'tell application "System Events" to return name of every process whose name contains "Affinity"'

屏幕截图权限

对于 affinity_screenshot,你还需要 屏幕录制 系统设置>隐私和安全>屏幕录制中的权限。

贡献

看 贡献.md 有关添加工具、提交PR和报告问题的指导方针。

许可证

麻省理工学院 --版权所有(c)2025 Sekhar Malla

常见问题

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

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

Affinity MCP Server 怎么在 Claude Desktop、Claude、Cursor 里配置?

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

Affinity MCP Server 收费吗?

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

Affinity MCP Server 需要 API Key 吗?

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

Affinity MCP Server 支持哪些客户端?

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

Affinity MCP Server 能提供哪些能力?

资料显示约 23 个工具;能力标签包括 AI自动化、TypeScript、Claude。具体工具清单以官方文档为准。

热门专题

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

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