🎯 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.

✨ Core 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

🚀 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.

🎮 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

🔧 Configuration

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | BARK_KEY | ✅ | - | Your Bark push key | | LANGUAGE | ❌ | en | Notification language (see supported languages above) | | MIN_DURATION_SECONDS | ❌ | 60 | Minimum duration to trigger notification | | IDE_BUNDLE_IDS | ❌ | Auto-detect | Custom IDE identifiers |

🛠️ 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

• 中文文档 - 简体中文版本
• 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