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 官方文档 或联系支持团队。