🧩 MCP-Servers

A collection of hand-crafted Model Context Protocol servers that give AI assistants direct, structured access to the tools you use every day.

---

✨ What is this?

This repository hosts MCP servers — small, focused services that expose the capabilities of external tools and platforms through the Model Context Protocol. With them, your AI assistant can read, create, and manage real data inside your favorite apps, with type-safe tools, clean schemas, and predictable outputs.

Each server lives in its own folder and is self-contained: build, configure, and plug it into any MCP-compatible client (Claude Desktop, Cursor, VS Code, n8n, and more).

🗂️ Repository layout

mcp-servers/
├── planka-mcp/          # Full CRUD + workflow tools for Planka
├── n8n-mcp/             # Workflows, ejecuciones y tags de n8n
├── pufferpanel-mcp/     # Servidores, power, consola y stats de PufferPanel
└── README.md

🧰 Available servers

Server	Description	Status
planka-mcp	Interact with a Planka instance — projects, boards, lists, cards, comments, labels, attachments, tasks, memberships and notifications, via API key or JWT.	✅ Active
n8n-mcp	Interact with an n8n instance — workflows (list/get/create/update/delete/activate/deactivate) and executions, via API key.	✅ Active
pufferpanel-mcp	Manage a PufferPanel instance — servers, power actions, console commands, stats, nodes and users, via API key.	✅ Active

---

⚙️ n8n-mcp

An MCP server for n8n, the workflow automation platform. Lets AI assistants manage workflows and inspect executions.

✅ Features

• Workflows — list, get, create, update and delete
• Workflow state — activate and deactivate
• Executions — list (with filters) and get details
• Tags — list available tags

10 tools, typed with Zod input/output schemas and operation hints.

🚀 Getting started

cd n8n-mcp
npm install
npm run build
cp .env.example .env

Then set:

N8N_URL=https://n8n.your-instance.com/api/v1
N8N_API_KEY=your_n8n_api_key     # Settings > API in n8n

🔌 Connecting to an MCP client

{
  "mcpServers": {
    "n8n": {
      "command": "node",
      "args": ["C:/path/to/mcp-servers/n8n-mcp/dist/src/index.js"],
      "env": {
        "N8N_URL": "https://n8n.your-instance.com/api/v1",
        "N8N_API_KEY": "your_n8n_api_key"
      }
    }
  }
}

---

🖥️ pufferpanel-mcp

An MCP server for PufferPanel, the open-source game/application hosting panel. Lets AI assistants control game servers and the panel.

✅ Features

• Servers — list, get detail and status
• Power — start, stop, restart and kill
• Console — send commands to a running server
• Stats — CPU, memory and disk usage
• Admin — list nodes and users

11 tools, typed with Zod input/output schemas and operation hints.

🚀 Getting started

cd pufferpanel-mcp
npm install
npm run build
cp .env.example .env

Then set:

PUFFERPANEL_URL=https://pufferpanel.your-instance.com
PUFFERPANEL_API_KEY=your_api_key   # API Keys section in the panel

🔌 Connecting to an MCP client

{
  "mcpServers": {
    "pufferpanel": {
      "command": "node",
      "args": ["C:/path/to/mcp-servers/pufferpanel-mcp/dist/src/index.js"],
      "env": {
        "PUFFERPANEL_URL": "https://pufferpanel.your-instance.com",
        "PUFFERPANEL_API_KEY": "your_api_key"
      }
    }
  }
}

---

🗿 planka-mcp

An MCP server for Planka, the open-source Trello alternative. It lets AI assistants manage your entire Planka workspace end-to-end.

✅ Features

• Projects — list, view, create, update and delete
• Boards — list, view, create, update and delete
• Lists — list, create, update, delete and move cards between them
• Cards — list, view, create, update, duplicate and delete
• Comments — list, create, update and delete
• Labels — list, create, update, delete, add to / remove from cards
• Attachments — create and delete
• Tasks (checklists) — create checklists, create and update checklist items
• Memberships — add board/card members and remove them
• Notifications — list, mark as read, and mark all as read

38 tools, every one with typed Zod input/output schemas and safe operation hints (read-only, idempotent, destructive) so AI clients use them responsibly.

🚀 Getting started

cd planka-mcp
npm install
npm run build
cp .env.example .env

Then set your environment variables:

PLANKA_URL=https://planka.your-instance.com
PLANKA_API_KEY=your_api_key            # generated once with `npm run setup`
PLANKA_INSECURE_TLS=0                   # set to 1 if using self-signed certs

Tip: run npm run setup once to auto-generate a working API key for your Planka instance.

🔌 Connecting to an MCP client

Point your client at the built server entry point. For example, in Claude Desktop / claude_desktop_config.json:

{
  "mcpServers": {
    "planka": {
      "command": "node",
      "args": ["C:/path/to/mcp-servers/planka-mcp/dist/src/index.js"],
      "env": {
        "PLANKA_URL": "https://planka.your-instance.com",
        "PLANKA_API_KEY": "your_api_key"
      }
    }
  }
}

🧪 Developer tooling

npm run inspect   # open the MCP Inspector for interactive tool testing

---

🤝 Contributing

Have another tool you want to wrap as an MCP server? Contributions are very welcome!

1. Fork the repo and create your branch (git checkout -b feat/my-server)
2. Add your server as a new folder, following the existing structure
3. Open a pull request — please include a short entry in the server table above

⚖️ License

Copyright © 2026 Xainner. All rights reserved.

---

Built with ❤️ and the Model Context Protocol SDK