🐤 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!