生产力增强服务器

Duckie Productivity MCP Server是一款结合了橡皮鸭调试、智能任务跟踪、专注计时器和Spotify集成的生产力工具,旨在提升开发者的工作效率和心情。

  • by SamarthShukla17
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 samarthshukla17/duckie-productivity-mcp-server

使用说明

🐤 Duckie生产力MCP服务器🚀

🦆 “令人惊叹的生产力,就在边缘!”

A. 模型上下文协议(MCP)服务器 不像其他人—— Duckie生产力服务器 组合橡胶鸭调试🐤, 智能任务跟踪📋, 焦点会话计时器⏱️, 以及由Spotify驱动的氛围🎧, 所有这些都充满了愉快的鸭子性格,可以振奋你的精神,让你的代码保持流畅。

🌐 实时网址: https://66bc69efc66f844b6f89c379.fp.dev
🔗 MCP端点: /mcp


✨ 特性

🧠 AI驱动的橡胶鸭调试

“让我们一起深入研究这个虫子,嘎嘎!”
开始一个调试会话,描述你的问题,让我们友好的鸭子AI(由Llama 3.1通过Workers AI提供支持)一步一步地引导你,并伴随着令人愉快的嘎嘎声鼓励。

✅ 智能任务管理

“你有任务吗?让我们像小鸭子一样把它们排成一行!”
创建、查看、更新和删除具有优先级、状态和截止日期的任务。Duckie记得一切,并帮助你保持条理。

⏳ 焦点定时器会话(番茄风格)

“让我们进入全嘎嘎叫模式25分钟!”
开始/恢复/暂停计时器,跟踪焦点统计数据,并通过番茄钟式的流程提高生产力——Duckie一路为你加油!

🎶 Spotify集成

“每个伟大的开发人员都应该有一个更棒的播放列表。让我们把音量调大!”
通过Spotify进行身份验证,搜索和播放曲目,暂停/恢复,并获得鸭子策划的果酱,以保持完美的氛围。


🚀 快速入门指南(适用于MCP客户)

将您的AI助手连接到MCP端点:

const mcp = createMCPAgent({
  endpoint: "https://66bc69efc66f844b6f89c379.fp.dev/mcp",
});


Available tools include:

create_task, list_tasks, update_task, delete_task

start_debug_session, resolve_debug_session

start_focus_session, complete_focus_session, get_focus_stats

spotify_auth_url

🧪 Ready to power up your assistant with full-stack productivity? Quack yeah.

📡 API Usage Examples
# 🐥 List all tasks
curl https://66bc69efc66f844b6f89c379.fp.dev/api/tasks

# 🐥 Create a task
curl -X POST https://66bc69efc66f844b6f89c379.fp.dev/api/tasks \
  -H "Content-Type: application/json" \
  -d '{"title":"Fix login bug", "priority":"high", "status":"todo"}'

# 🐥 Start a debug session
curl -X POST https://66bc69efc66f844b6f89c379.fp.dev/api/debug/sessions \
  -H "Content-Type: application/json" \
  -d '{"title":"API Error", "problem_description":"Getting 500 when submitting form"}'

# 🐥 Start a focus session
curl -X POST https://66bc69efc66f844b6f89c379.fp.dev/api/focus/sessions \
  -H "Content-Type: application/json" \
  -d '{"duration_minutes":25, "task_description":"Work on UI"}'


📘 API Documentation
Endpoint	Method	Description
/mcp	POST	Main MCP JSON-RPC endpoint
/api/tasks	GET/POST/PUT/DELETE	Task CRUD operations
/api/debug/sessions	POST, PUT	Create or resolve debug sessions
/api/focus/sessions	POST, PUT	Manage focus timers
/api/spotify/auth	GET	Start Spotify OAuth
/api/spotify/callback	GET	OAuth redirect handler
/api/spotify/search	GET	Search for tracks/playlists
/api/spotify/play	POST	Start playback
/api/spotify/pause	POST	Pause playback

🧱 Database Schema (D1)
sql
Copy
Edit
-- tasks
id INTEGER PRIMARY KEY AUTOINCREMENT
title TEXT NOT NULL
description TEXT
status TEXT CHECK(status IN ('todo','in_progress','done'))
priority TEXT CHECK(priority IN ('low','medium','high'))
due_date DATETIME
created_at DATETIME DEFAULT CURRENT_TIMESTAMP
updated_at DATETIME

-- debug_sessions
id INTEGER PRIMARY KEY AUTOINCREMENT
session_id TEXT UNIQUE
title TEXT
problem_description TEXT
conversation_history TEXT
created_at DATETIME
updated_at DATETIME

-- focus_sessions
id INTEGER PRIMARY KEY AUTOINCREMENT
session_id TEXT
duration_minutes INTEGER
status TEXT CHECK(status IN ('active','completed'))
start_time DATETIME
end_time DATETIME
task_description TEXT

-- spotify_tokens
id INTEGER PRIMARY KEY AUTOINCREMENT
user_id TEXT
access_token TEXT
refresh_token TEXT
expires_at DATETIME
scope TEXT
created_at DATETIME
updated_at DATETIME
🛠️ Development Setup
bash
Copy
Edit
# 1. Clone the repo
git clone https://github.com/your-username/duckie-productivity-mcp-server
cd duckie-productivity-mcp-server

# 2. Install dependencies
npm install

# 3. Set environment variables (in .env)
SPOTIFY_CLIENT_ID=your_client_id
SPOTIFY_CLIENT_SECRET=your_client_secret
SPOTIFY_REDIRECT_URI=https://yourdomain.dev/api/spotify/callback

# 4. Start local dev (via Miniflare)
npm run dev
🐣 Cloudflare D1 and Workers AI are automatically available via c.env.

🦆 Duck Personality: What Makes Duckie Special?
Every interaction with Duckie is:

🧡 Encouraging — "You’ve got this, fellow developer!"

🐣 Friendly — "Hey hey! Ready to quack some bugs?"

🌈 Motivational — "Let’s paddle through this one line at a time."

Even when you're stuck, Duckie keeps your spirits up with humor, heart, and high-fives (er, wing-flaps). Expect a cheerful tone in AI responses, error messages, and even loading states!

🏆 Built For: Vibe Summer Challenge
This project showcases the power of Cloudflare’s edge ecosystem:

⚡ Cloudflare Workers for blazing-fast APIs

🧠 Workers AI for serverless intelligence (Llama 3.1, 8B)

🗃️ Cloudflare D1 for relational data at the edge

🎵 Real-time Spotify integration

🧩 Model Context Protocol (MCP) for tooling assistants

It’s a productivity stack — with personality.

🤝 Acknowledgments
🧑‍💻 @modelcontextprotocol/sdk

☁️ Cloudflare Workers + D1 + Workers AI

🧠 Meta’s Llama 3.1 via Workers AI

🎵 Spotify Web API

🛠️ Hono.js + Drizzle ORM

📄 License
This project is licensed under the MIT License. See LICENSE for details.

🐥 Built with feathers, code, and lots of quacking love. Dive into productivity with Duckie — your new favorite AI rubber duck!