MCP Server Nyantify

🔮 Nyantify

Let AI do the work. Nyantify will call you when it's done.

Nyantify is a smart notification middleware that teaches AI assistants to interrupt politely, allowing you to focus on your work without constantly worrying about tasks' completion status.

Smart notification middleware that teaches AI assistants to interrupt politely

English · 中文

🚀 Quick Start

Prerequisites

• macOS / Windows / Linux
• Node.js 18+
• Bark iOS App - Free open-source push notification app

What is Bark?

Bark is an open-source iOS push notification tool that lets you send custom notifications to your iPhone via simple HTTP requests.

• ✅ Free & Open Source - MIT licensed, full source code on GitHub
• ✅ Privacy First - Uses Apple Push Notification Service (APNs), no battery drain
• ✅ Advanced Features - Time-sensitive notifications, custom sounds, groups, encryption
• ✅ Self-Hostable - Run your own Bark server if needed

Download: App Store | GitHub

1. Get Your Bark Key

1. Install Bark on your iPhone.
2. Open the app and copy your unique key.
3. You'll use this key in the MCP configuration.

2. Configure Your AI Assistant

OpenCode (~/.config/opencode/opencode.json):

{
  "mcp": {
    "nyantify": {
      "type": "local",
      "command": ["npx", "-y", "mcp-server-nyantify"],
      "environment": {
        "BARK_KEY": "your_bark_key_here",
        "LANGUAGE": "en"
      }
    }
  }
}

Claude Desktop:

{
  "mcpServers": {
    "nyantify": {
      "command": "npx",
      "args": ["-y", "mcp-server-nyantify"],
      "env": {
        "BARK_KEY": "your_bark_key_here"
      }
    }
  }
}

That's it! No installation needed - npx will download and run it automatically.

3. Restart and Done

Restart your AI assistant. Nyantify will now track all conversations and notify you when long tasks complete.

✨ Features

1. Smart Do Not Disturb

You're coding in IDE → Complete silence
You leave IDE to check phone → Gentle reminder

2. Time-Aware

Short tasks (<60s) → Silent completion
Long tasks (>60s) → Push to phone

3. Project-Aware

Shows your current folder name so you know which project the notification belongs to.

4. Multi-Language Support 🇺🇳

en zh ja de fr es ru ko pt it ar hi vi th

🎯 What Problem Does It Solve?

When you ask your AI assistant to perform long-running tasks (code refactoring, test execution, build deployment), you often face these dilemmas:

• ❌ Staring at the screen waiting - Don't know when AI will finish
• ❌ Switching to do something else - Forget to check back, task abandoned
• ❌ Frequently checking progress - Disrupts your own workflow
• ❌ Bombarded with irrelevant notifications - Get reminders even when focused on coding

Nyantify = The "doorbell system" for AI work Only nudges you when you truly need to know.

🎮 How It Works

Every conversation automatically follows this flow:

Chat Starts
    ↓
track({action: "start"}) → Timer starts
    ↓
AI works while you do other things
    ↓
track({action: "end"}) → Check duration & IDE focus
    ↓
    ├─ Duration > 60s & Left IDE → 📱 Notify
    └─ Otherwise → 🔕 Silent

Notification Example:

Title: Nyantify · Task Completed · 2min30s
Subtitle: my-awesome-project
Body: Refactoring authentication module

🔧 Technical Details

Configuration

🛠️ For Developers

Local Development

git clone https://github.com/ArtrixTech/mcp-server-nyantify.git
cd mcp-server-nyantify
npm install
npm run build
npm run start

Publishing to NPM

1. Login to NPM:

   npm login
   

2. Update version (following semver):

   npm version patch  # or minor/major
   

3. Publish:

   npm publish
   

4. Verify:

   npm view mcp-server-nyantify
   

See PUBLISHING.md for detailed release workflow.

📚 Documentation

• 中文文档 - Simplified Chinese version
• Architecture - System design details
• Contributing - How to contribute

🤝 Contributing

PRs welcome! See Contributing Guide.

🙏 Acknowledgments

• Bark - The fantastic open-source iOS notification app
• Model Context Protocol - Making AI tools interoperable

📄 License

MIT License © 2024 Artrix