金大哥 - dart-mcp-server MCP 详情

article

README

🚀 Dart MCP 服务器

Dart 是一款任务管理工具，借助 MCP（模型上下文协议）服务器与 AI 助手（如 Claude）实现集成。该服务器支持 AI 调用 Dart 的各项功能，涵盖创建与更新任务、组织文档以及管理工作区和文件夹等操作，极大提升了任务管理的效率和智能化程度。

🚀 快速开始

在使用 Dart MCP 服务器之前，需要完成一些先决条件的准备工作：

安装 Node.js 和 npm
确保系统上已安装 Node.js 和 npm。可以访问 Node.js 官网下载并安装最新版本。
安装 Python 和 pip
确保系统上安装了 Python 3 和 pip。可以通过以下命令检查和安装：
```
python --version
pip install --upgrade pip
```
安装 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="已完成")

📚 详细文档

开发步骤

克隆仓库：

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

可用的 MCP 工具

创建任务：dart createtask
更新任务：dart updatetask
查询任务：dart listtasks

📄 帮助和支持

如需帮助，请访问 Dart 官方文档或联系支持团队。

dart-mcp-server