Affinity Designer

v1.0.0Developer Toolsstable

MCP (Model Context Protocol) server for Affinity Designer integration

mcp-affinity-designermcpai-integration
Share:
10
Stars
0
Downloads
0
Weekly
0/5

What is Affinity Designer?

Affinity Designer is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp (model context protocol) server for affinity designer integration

MCP (Model Context Protocol) server for Affinity Designer integration

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP (Model Context Protocol) server for Affinity Designer in

Use Cases

Integrate Affinity Designer with AI assistants through MCP.
szgk

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMay 7, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcp-affinity-designer

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Affinity Designer

The Affinity Designer MCP Server integrates Affinity Designer 2 with AI assistants through the Model Context Protocol. Built in TypeScript with Node.js, it currently provides server status inspection and Affinity Designer installation verification tools, with primary support for Windows via PowerShell, COM, and Win32 APIs. macOS support via AppleScript is planned.

Prerequisites

  • Node.js 18.0.0 or later
  • TypeScript 5.0 or later (installed as a dev dependency)
  • Affinity Designer 2 installed via MSI installer to the default Program Files location (not Microsoft Store version)
  • Git to clone the repository
  • Windows OS (primary platform); macOS support is experimental
1

Clone the repository

Clone the mcp-affinity-designer repository from GitHub.

git clone https://github.com/szgk/mcp-affinity-designer.git
cd mcp-affinity-designer
2

Install Node.js dependencies

Install all npm dependencies including the MCP SDK and TypeScript toolchain.

npm install
3

Build the TypeScript source

Compile the TypeScript source files to JavaScript in the dist/ directory.

npm run build
4

Configure custom Affinity Designer installation path (optional)

If Affinity Designer 2 is installed in a non-default location, create an affinity-install-paths.json file in the project root. Use double backslashes for Windows paths.

{
  "windows": "C:\\Program Files\\Affinity\\Designer 2\\Designer.exe",
  "mac": "/Applications/Affinity Designer 2.app/Contents/MacOS/Affinity Designer 2"
}
5

Register with Claude Desktop

Add the MCP server to claude_desktop_config.json using the compiled dist/index.js entry point.

{
  "mcpServers": {
    "affinity-designer": {
      "command": "node",
      "args": ["C:\\Projects\\mcp-affinity-designer\\dist\\index.js"]
    }
  }
}
6

Verify installation with get_server_info

Restart Claude Desktop and ask Claude to call get_server_info or check_affinity_designer to confirm the server is running and Affinity Designer is detected.

# Prompts to verify:
"Get server info from the Affinity Designer MCP server"
"Check if Affinity Designer is installed on this machine"

Affinity Designer Examples

Client configuration

Claude Desktop claude_desktop_config.json for the Affinity Designer MCP server using the compiled Node.js bundle.

{
  "mcpServers": {
    "affinity-designer": {
      "command": "node",
      "args": ["C:\\Projects\\mcp-affinity-designer\\dist\\index.js"]
    }
  }
}

Prompts to try

Example prompts using the two currently available tools: get_server_info and check_affinity_designer.

- "Get server info from the Affinity Designer MCP server"
- "Check if Affinity Designer 2 is installed and report the installation path"
- "What is the operational status of the Affinity Designer MCP server?"
- "Verify my Affinity Designer installation before I start a design session"

Troubleshooting Affinity Designer

check_affinity_designer returns 'not found' even though Affinity Designer is installed

The server expects Affinity Designer 2 installed via the MSI installer at `C:\Program Files\Affinity\Designer 2\Designer.exe`. If you used a different installation method or location, create affinity-install-paths.json in the project root with the correct path using double backslashes.

npm run build fails with TypeScript compilation errors

Ensure you have Node.js 18+ installed (`node --version`) and that npm install completed without errors. Run `npm run typecheck` separately to see all type errors. If the issue persists, delete node_modules and package-lock.json and re-run npm install.

Claude Desktop does not load the server after configuration

Use the absolute Windows path with double backslashes in the args array. Relative paths do not work in claude_desktop_config.json. Confirm the dist/index.js file exists by running `npm run build` first. Restart Claude Desktop fully—not just reload—after editing the config.

Frequently Asked Questions about Affinity Designer

What is Affinity Designer?

Affinity Designer is a Model Context Protocol (MCP) server that mcp (model context protocol) server for affinity designer integration It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Affinity Designer?

Follow the installation instructions on the Affinity Designer GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Affinity Designer?

Affinity Designer works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Affinity Designer free to use?

Yes, Affinity Designer is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcp-affinity-designer": { "command": "npx", "args": ["-y", "mcp-affinity-designer"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Affinity Designer?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides