Dart MCP Server

🚀 Dart MCP 服務器

Dart 是一款任務管理工具，藉助 MCP（模型上下文協議）服務器與 AI 助手（如 Claude）實現集成。該服務器支持 AI 調用 Dart 的各項功能，涵蓋創建與更新任務、組織文檔以及管理工作區和文件夾等操作，極大提升了任務管理的效率和智能化程度。

🚀 快速開始

在使用 Dart MCP 服務器之前，需要完成一些先決條件的準備工作：

1. 安裝 Node.js 和 npm
   確保系統上已安裝 Node.js 和 npm。可以訪問 Node.js 官網 下載並安裝最新版本。
2. 安裝 Python 和 pip
   確保系統上安裝了 Python 3 和 pip。可以通過以下命令檢查和安裝：

   python --version
   pip install --upgrade pip
   

3. 安裝 Dart 工具
   克隆 Dart 倉庫並按照 Dart 安裝指南 進行安裝。

✨ 主要特性

• 任務管理：支持創建、更新和查詢任務，讓任務的全生命週期管理更加便捷。
• 文檔管理：能夠創建和組織文檔，方便對項目相關資料進行整理。
• 工作區和文件夾管理：可對 Dartboard 中的工作區和文件夾進行有效管理，優化工作空間佈局。
• Dartboard 集成：與 Dart 的其他功能實現無縫集成，提供統一的操作體驗。

📦 安裝指南

通過 Smithery 安裝

# 克隆倉庫
git clone https://github.com/its-dart/dart-tools.git
cd dart-tools/dart/mcp

# 安裝依賴項
npm install

# 初始化 Python 環境
python -m venv .venv
source .venv/bin/activate  # 在 Windows 上使用 .venv\Scripts\activate
pip install dart-tools

# 配置環境變量
cp .env.example .env
# 編輯 .env 文件，設置你的 DART_TOKEN

手動安裝

# 克隆倉庫
git clone https://github.com/its-dart/dart-tools.git
cd dart-tools/dart/mcp

# 安裝依賴項
npm install

# 初始化 Python 環境
python -m venv .venv
source .venv/bin/activate  # 在 Windows 上使用 .venv\Scripts\activate
pip install dart-tools

# 配置環境變量
cp .env.example .env
# 編輯 .env 文件，設置你的 DART_TOKEN

💻 使用示例

基礎用法

創建任務

dart createtask "更新登錄頁面" -p0 --tag 營銷

更新任務

dart updatetask [DUID] -s 已完成

高級用法

Python 庫使用示例

import os
from dart import create_task, is_logged_in, update_task

is_logged_in(should_raise=True)

new_task = create_task(
    "更新登錄頁面", 
    priority_int=0, 
    tag_titles=["營銷"]
)

update_task(new_task.duid, status_title="已完成")

📚 詳細文檔

開發步驟

1. 克隆倉庫：

   git clone https://github.com/its-dart/dart-tools.git
   cd dart-tools/dart/mcp
   

2. 安裝依賴項：

   npm install
   

3. 初始化 Python 環境並安裝包：

   python -m venv .venv
   source .venv/bin/activate  # 在 Windows 上使用 .venv\Scripts\activate
   pip install dart-tools
   

4. 配置環境變量：

   cp .env.example .env
   # 編輯 .env 文件，設置你的 DART_TOKEN
   

可用的 MCP 工具

• 創建任務：dart createtask
• 更新任務：dart updatetask
• 查詢任務：dart listtasks

📄 幫助和支持

如需幫助，請訪問 Dart 官方文檔 或聯繫支持團隊。