{"id":31810884,"url":"https://github.com/toolprint/mcping-mcp","last_synced_at":"2025-10-11T06:17:34.154Z","repository":{"id":311778833,"uuid":"1023754708","full_name":"toolprint/mcping-mcp","owner":"toolprint","description":"A helpful MCP that allows you to push OSX notifications from a toolcall!","archived":false,"fork":false,"pushed_at":"2025-07-21T21:32:42.000Z","size":270,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-28T07:30:47.932Z","etag":null,"topics":["mcp","mcp-server","mcping","mcping-mcp","model-context-protocol","notification","osx-notifications","push-notification","push-notification-server","toolprint"],"latest_commit_sha":null,"homepage":"https://toolprint.ai","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/toolprint.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-21T16:35:11.000Z","updated_at":"2025-08-13T03:36:52.000Z","dependencies_parsed_at":"2025-08-26T19:12:36.348Z","dependency_job_id":"680dc53f-e68f-4284-893b-25a5d276f29b","html_url":"https://github.com/toolprint/mcping-mcp","commit_stats":null,"previous_names":["toolprint/mcping-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/toolprint/mcping-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toolprint%2Fmcping-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toolprint%2Fmcping-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toolprint%2Fmcping-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toolprint%2Fmcping-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/toolprint","download_url":"https://codeload.github.com/toolprint/mcping-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toolprint%2Fmcping-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279006450,"owners_count":26084107,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-11T02:00:06.511Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mcp","mcp-server","mcping","mcping-mcp","model-context-protocol","notification","osx-notifications","push-notification","push-notification-server","toolprint"],"created_at":"2025-10-11T06:17:27.066Z","updated_at":"2025-10-11T06:17:34.147Z","avatar_url":"https://github.com/toolprint.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MCPing - macOS Notification MCP Server\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![npm version](https://img.shields.io/npm/v/@toolprint/mcping-mcp.svg)](https://www.npmjs.com/package/@toolprint/mcping-mcp)\n[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)\n\n\u003e I got a notification! 🎉 \n\nMCPing is a Model Context Protocol (MCP) server that enables AI assistants to send desktop notifications on macOS. Finally, your AI can tap you on the shoulder instead of just sitting there quietly being brilliant.\n\n## Installation\n\n**Prerequisites**: Node.js 18+ and macOS (for notifications)\n\n### Quick Start (Recommended)\n\nAdd to your MCP client settings:\n\n```jsonw\n{\n  \"mcpServers\": {\n    \"toolprint-mcping\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@toolprint/mcping-mcp@latest\"]\n    }\n  }\n}\n```\n\n### Manual Installation\n\n```bash\nnpm install -g @toolprint/mcping-mcp@latest\nmcping-mcp\n```\n\n## Configuration\n\n### For Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"mcping\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@toolprint/mcping-mcp@latest\"]\n    }\n  }\n}\n```\n\n### For Development (HTTP Mode)\n\n```bash\n# Run in HTTP mode for testing\nnpx @toolprint/mcping-mcp@latest --transport http --port 3000\n\n# Test with curl\ncurl -X POST http://localhost:3000/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"id\": 1,\n    \"method\": \"tools/call\",\n    \"params\": {\n      \"name\": \"send-notification\",\n      \"arguments\": {\n        \"title\": \"Hello World\",\n        \"message\": \"This is a test notification\"\n      }\n    }\n  }'\n```\n\n## Usage\n\nOnce configured, ask your AI assistant:\n\n- \"Send a notification saying the build is complete\"\n- \"Send a critical alert that the server is down\"\n- \"Send a quiet reminder to take a break\"\n- \"Notify me with title 'Tests Passed' and message 'All 127 tests passed'\"\n\n### Tool: send-notification\n\nSend desktop notifications on macOS with rich formatting options.\n\n**Parameters:**\n- `title` (required): Notification title (1-100 characters)\n- `message` (required): Notification message (1-500 characters)  \n- `subtitle` (optional): Additional context (max 100 characters)\n- `urgency` (optional): `\"low\"` | `\"normal\"` | `\"critical\"` (default: `\"normal\"`)\n- `sound` (optional): Play notification sound (default: `true`)\n- `timeout` (optional): Display duration in seconds, 1-60 (default: 10)\n\n**Examples:**\n\n```javascript\n// Basic notification\n{\n  \"title\": \"Task Complete\",\n  \"message\": \"Your build finished successfully\"\n}\n\n// Critical alert with subtitle\n{\n  \"title\": \"Server Down\",\n  \"message\": \"Production server is not responding\",\n  \"subtitle\": \"api.example.com\",\n  \"urgency\": \"critical\",\n  \"sound\": true,\n  \"timeout\": 60\n}\n\n// Quiet reminder\n{\n  \"title\": \"Break Time\",\n  \"message\": \"You've been coding for 2 hours\",\n  \"urgency\": \"low\",\n  \"sound\": false,\n  \"timeout\": 10\n}\n```\n\n## Troubleshooting\n\n### Notifications Not Appearing?\n\n1. **Check Permissions**: System Preferences → Notifications → Terminal (allow notifications)\n2. **Do Not Disturb**: Ensure DND is disabled or use `urgency: \"critical\"`\n3. **Verbose Mode**: Run with `--verbose` flag for detailed logs\n\n### Common Issues\n\n- **\"Permission denied\"**: Grant Terminal notification permissions in System Preferences\n- **\"Not available\"**: Ensure you're running on macOS\n- **\"Rate limited\"**: Wait between sending multiple notifications\n\n## Development\n\n```bash\n# Clone repository\ngit clone https://github.com/toolprint/mcping-mcp.git\ncd mcping-mcp\n\n# Install dependencies\nnpm install\n\n# Run tests\nnpm test\n\n# Build\nnpm run build\n\n# Development mode\nnpm run dev\n```\n\n## License\n\nMIT © [Toolprint](https://toolprint.ai)\n\n### Usage\n\nWhen using, forking, or distributing this software, the MIT License requires that you include the original copyright notice (\"Copyright © OneGrep, Inc.\") and license text in all copies or substantial portions of the software. This attribution requirement ensures proper credit to the original authors while allowing you to freely use, modify, and distribute the code.\n\n## About Toolprint\n\nBuilding tools for the AI agent ecosystem. Visit [toolprint.ai](https://toolprint.ai) to explore our suite of MCP servers and developer tools.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cstrong\u003eMCPing\u003c/strong\u003e - Desktop notifications for AI assistants\u003cbr\u003e\n  Made with ❤️ by \u003ca href=\"https://toolprint.ai\"\u003eToolprint\u003c/a\u003e\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoolprint%2Fmcping-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftoolprint%2Fmcping-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoolprint%2Fmcping-mcp/lists"}