feat: Add MCP server icon support (SEP-973) v2.20.0 (#333)

* feat: Add MCP server icon support (SEP-973) v2.20.0

Implements custom server icons for MCP clients according to the MCP
specification SEP-973. Icons enable better visual identification of
the n8n-mcp server in MCP client interfaces.

Features:
- Added 3 icon sizes: 192x192, 128x128, 48x48 (PNG format)
- Icons served from https://www.n8n-mcp.com/logo*.png
- Added websiteUrl field pointing to https://n8n-mcp.com
- Server version now uses package.json (PROJECT_VERSION) instead of hardcoded '1.0.0'

Changes:
- Upgraded @modelcontextprotocol/sdk from ^1.13.2 to ^1.20.1
- Updated src/mcp/server.ts with icon configuration
- Bumped version to 2.20.0
- Updated CHANGELOG.md with release notes

Testing:
- All icon URLs verified accessible (HTTP 200, CORS enabled)
- Build passes, type checking passes
- No breaking changes, fully backward compatible

Icons won't display in Claude Desktop yet (pending upstream UI support),
but will appear automatically when support is added. Other MCP clients
may already support icon display.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* docs: Fix icon URLs in CHANGELOG to reflect actual implementation

The CHANGELOG incorrectly documented icon URLs as
https://api.n8n-mcp.com/public/logo-*.png when the actual
implementation uses https://www.n8n-mcp.com/logo*.png

This updates the documentation to match the code.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>
This commit is contained in:
Romuald Członkowski
2025-10-18 19:01:32 +02:00
committed by GitHub
parent 0f5b0d9463
commit 5881304ed8
5 changed files with 57 additions and 9 deletions

View File

@@ -5,6 +5,36 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [2.20.0] - 2025-10-18
### ✨ Features
**MCP Server Icon Support (SEP-973)**
- Added custom server icons for MCP clients
- Icons served from https://www.n8n-mcp.com/logo*.png
- Multiple sizes: 48x48, 128x128, 192x192
- Future-proof for Claude Desktop icon UI support
- Added websiteUrl field pointing to https://n8n-mcp.com
- Server now reports correct version from package.json instead of hardcoded '1.0.0'
### 📦 Dependency Updates
- Upgraded `@modelcontextprotocol/sdk` from ^1.13.2 to ^1.20.1
- Enables icon support as per MCP specification SEP-973
- No breaking changes, fully backward compatible
### 🔧 Technical Improvements
- Server version now dynamically sourced from package.json via PROJECT_VERSION
- Enhanced server metadata to include branding and website information
### 📝 Notes
- Icons won't display in Claude Desktop yet (pending upstream UI support)
- Icons will appear automatically when Claude Desktop adds icon rendering
- Other MCP clients (Cursor, Windsurf) may already support icon display
## [2.19.6] - 2025-10-14
### 📦 Dependency Updates

Binary file not shown.

12
package-lock.json generated
View File

@@ -1,15 +1,15 @@
{
"name": "n8n-mcp",
"version": "2.18.11",
"version": "2.20.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "n8n-mcp",
"version": "2.18.11",
"version": "2.20.0",
"license": "MIT",
"dependencies": {
"@modelcontextprotocol/sdk": "^1.13.2",
"@modelcontextprotocol/sdk": "^1.20.1",
"@n8n/n8n-nodes-langchain": "^1.114.1",
"@supabase/supabase-js": "^2.57.4",
"dotenv": "^16.5.0",
@@ -9304,9 +9304,9 @@
}
},
"node_modules/@modelcontextprotocol/sdk": {
"version": "1.18.1",
"resolved": "https://registry.npmjs.org/@modelcontextprotocol/sdk/-/sdk-1.18.1.tgz",
"integrity": "sha512-d//GE8/Yh7aC3e7p+kZG8JqqEAwwDUmAfvH1quogtbk+ksS6E0RR6toKKESPYYZVre0meqkJb27zb+dhqE9Sgw==",
"version": "1.20.1",
"resolved": "https://registry.npmjs.org/@modelcontextprotocol/sdk/-/sdk-1.20.1.tgz",
"integrity": "sha512-j/P+yuxXfgxb+mW7OEoRCM3G47zCTDqUPivJo/VzpjbG8I9csTXtOprCf5FfOfHK4whOJny0aHuBEON+kS7CCA==",
"license": "MIT",
"dependencies": {
"ajv": "^6.12.6",

View File

@@ -1,6 +1,6 @@
{
"name": "n8n-mcp",
"version": "2.19.6",
"version": "2.20.0",
"description": "Integration between n8n workflow automation and Model Context Protocol (MCP)",
"main": "dist/index.js",
"types": "dist/index.d.ts",
@@ -139,7 +139,7 @@
"vitest": "^3.2.4"
},
"dependencies": {
"@modelcontextprotocol/sdk": "^1.13.2",
"@modelcontextprotocol/sdk": "^1.20.1",
"@n8n/n8n-nodes-langchain": "^1.114.1",
"@supabase/supabase-js": "^2.57.4",
"dotenv": "^16.5.0",

View File

@@ -128,7 +128,25 @@ export class N8NDocumentationMCPServer {
this.server = new Server(
{
name: 'n8n-documentation-mcp',
version: '1.0.0',
version: PROJECT_VERSION,
icons: [
{
src: "https://www.n8n-mcp.com/logo.png",
mimeType: "image/png",
sizes: ["192x192"]
},
{
src: "https://www.n8n-mcp.com/logo-128.png",
mimeType: "image/png",
sizes: ["128x128"]
},
{
src: "https://www.n8n-mcp.com/logo-48.png",
mimeType: "image/png",
sizes: ["48x48"]
}
],
websiteUrl: "https://n8n-mcp.com"
},
{
capabilities: {