Mcpal

Name: Mcpal
Author: mjkid221

@mjkid221

代码仓库主页

关于 Mcpal

Friendly Companion MCP. Get notified when your task is finished!

基本信息

分类

其他

许可证

NOASSERTION

运行时

node

传输方式

stdio

发布者

mjkid221

提交者

MJ Lee

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcpal": {
      "command": "npx",
      "args": [
        "mcpal@latest"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is MCPal?

MCPal is a lightweight MCP server for native desktop notifications with action buttons, text replies, and LLM‑aware icons. It is compatible with any MCP client.

How to use MCPal?

Add MCPal to your MCP config manually (JSON or TOML) or via CLI for Codex or Claude Code. Then call the send_notification tool with parameters such as message, title, actions, dropdownLabel, and reply.

Key features of MCPal

Native desktop notifications with action buttons and text reply
LLM‑aware icons that detect the calling client
Input sanitization and truncation for reliability
Structured tool result contract with backward‑compatible text output
Custom app icon automatically configured during installation
Built‑in MCP instructions for proactive notification configuration

Use cases of MCPal

Notify when a long‑running task (build, test, deployment) completes
Ask for user approval or choice via action buttons (e.g., “Deploy” / “Cancel”)
Request free‑form text input from the user without switching apps
Provide task‑completion hooks for AI assistants to notify the user

FAQ from MCPal

What does MCPal do?

MCPal sends native desktop notifications from any MCP client, supporting action buttons, text replies, and client‑specific icons.

How do I install MCPal?

Add it to your MCP config with npx mcpal@latest (JSON/TOML) or use the CLI commands for Codex (codex mcp add mcpal -- npx -y mcpal@latest) or Claude Code (claude mcp add mcpal -- npx -y mcpal@latest).

What parameters does `send_notification` accept?

Required: message (string). Optional: title (default “MCPal”), actions (array of strings), dropdownLabel (string), reply (boolean).

Does MCPal support custom client icons?

Yes. To add a new client icon, place a 128×128 PNG (<10 KB) in src/assets/clients/ and update the mapping in src/notify.config.ts.

What are the input limits for notifications?

Title: 256 characters. Message: 4000 characters. Actions: max 3 items, each 64 characters. Dropdown label: 64 characters.

其他分类下的更多 MCP 服务器

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K