MCP 服务器

Dart MCP Server

一个基于 Dart 的 MCP 服务器实现，它通过标准化工具和无缝的 Dart 集成，实现 AI 辅助的任务管理、文档处理和工作区组织。

Tools

create_folder

Create a new folder in a space

get_dartboards

Get available dartboards

get_folders

Get available folders

get_default_status

Get the default status DUIDs

get_default_space

Get the default space DUID

create_task

Create a new Dart task

update_task

Update an existing task

create_doc

Create a new document or report

create_space

Create a new space

delete_space

Delete a space and all its contents

README

Dart MCP 服务器

一个用于 Dart 的模型上下文协议 (MCP) 服务器实现，通过 MCP 工具提供任务管理、文档处理和工作区组织功能。

前提条件

Node.js 16.x 或更高版本
Python 3.8 或更高版本
已安装 Dart Python SDK (pip install dart-sdk)
有效的 Dart API 令牌

功能

任务管理
- 创建和更新任务
- 设置任务优先级和状态
- 将任务分配给团队成员
文档管理
- 创建和组织文档
- 支持 markdown 内容
- 报告生成
空间管理
- 创建和管理工作区
- 使用文件夹组织内容
- 控制访问权限
Dartboard 集成
- 默认状态管理
- 任务组织
- 团队协作

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Dart MCP Server：

npx -y @smithery/cli install @jmanhype/dart-mcp-server --client claude

手动安装

克隆存储库：

git clone https://github.com/jmanhype/dart-mcp-server.git
cd dart-mcp-server

安装 Node.js 依赖项：

npm install

设置 Python 环境并安装 Dart SDK：

# 创建并激活虚拟环境
python -m venv .venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

# 安装 Dart SDK
pip install dart-sdk

设置环境变量：

# 复制示例环境变量文件
cp .env.example .env

# 使用您的配置编辑 .env
# 必需：DART_TOKEN
# 可选：PYTHONPATH（Dart SDK 的路径）

用法

构建 TypeScript 代码：

npm run build

启动 MCP 服务器：

npm start

开发

# 监听 TypeScript 更改
npm run dev

# 运行测试
npm test

环境变量

创建一个包含以下变量的 .env 文件：

# 必需：您的 Dart API 令牌
DART_TOKEN=your_dart_token_here

# 可选：您的 Dart SDK 安装路径
PYTHONPATH=/path/to/dart/sdk

# 可选：Python 可执行文件路径（默认为系统 Python）
PYTHON_PATH=/path/to/python

可用的 MCP 工具

create_task: 创建具有标题、描述、优先级等的新任务。
update_task: 更新现有任务的状态、标题、描述
get_default_status: 获取默认状态 DUID
get_default_space: 获取默认空间 DUID
get_dartboards: 列出可用的 dartboards
get_folders: 列出空间中的文件夹
create_folder: 创建新文件夹
create_doc: 创建新文档或报告
create_space: 创建新工作区
delete_space: 删除现有工作区

故障排除

如果您遇到问题：

验证 Python 环境：
```
python --version
pip list | grep dart
```

检查 Dart SDK 安装：

python -c "import dart; print(dart.__version__)"

验证环境变量：
```
echo $DART_TOKEN
echo $PYTHONPATH
```

许可证

MIT 许可证

Dart 工具

PyPI 支持的 Python 版本许可证

Dart 是由 AI 驱动的项目管理工具。

dart-tools 是 Dart CLI 和 Python 库。它支持通过终端 CLI 或 Python 与 Dart 直接集成。

安装
使用 CLI
使用 Python 库
在 AWS Lambda 函数中使用 Python 库
使用 MCP 服务器
高级用法
帮助和资源
贡献
许可证

安装

在终端中，运行以下命令进行安装

pip install dart-tools

使用 CLI

首先，通过以下命令设置身份验证

dart login

然后，您可以使用类似以下的命令创建一个新任务

dart createtask "Update the landing page" -p0 --tag marketing

这将创建一个名为“Update the landing page”的新任务，优先级为“Critical”（即 P0），并带有“marketing”标签。

您可以使用 dart --help 或更具体的子命令帮助（在本例中为 dart createtask --help）来探索所有这些选项以及更多选项。

另一个常见的工作流程是更新现有任务。为此，运行类似以下的命令

dart updatetask [DUID] -s Done

此命令会将引用的任务标记为“Done”。在这里，[DUID] 应该被替换（包括括号）为现有任务的“Dart ID”。您可以通过多种方式从任何现有任务中获取 DUID，例如从任务 URL 的末尾复制它，或者单击 Dart 中任务页面中的“...”按钮，然后选择“Copy ID”。

使用 Python 库

首先，设置身份验证。在终端中运行 dart login 以进行交互式过程，或访问您的 Dart 个人资料，然后运行 dart.login(token) 或将令牌保存到 DART_TOKEN 环境变量中。

然后，您可以运行类似以下的命令

import os
from dart import create_task, is_logged_in, update_task

# 检查是否已设置身份验证，如果未设置则停止，一旦一切设置完毕，可以删除此项
is_logged_in(should_raise=True)

# 创建一个名为“Update the landing page”的新任务，优先级为“Critical”（即 p0），并带有“marketing”标签
new_task = create_task(
    "Update the landing page", priority_int=0, tag_titles=["marketing"]
)

# 将任务更新为“Done”
update_task(new_task.duid, status_title="Done")

使用 MCP 服务器

模型上下文协议 (MCP) 服务器实现使 AI 助手（如 Claude）能够通过标准化工具与 Dart 交互。这允许将 AI 功能与 Dart 的任务管理系统无缝集成。

安装

# 克隆存储库
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
# 使用您的 DART_TOKEN 编辑 .env

可用的 MCP 工具

服务器提供以下 MCP 工具：

任务管理（创建/更新任务）
文档管理（创建/组织文档）
空间管理（工作区/文件夹）
Dartboard 集成

有关详细文档，请参阅 MCP Server README。

高级用法

几乎所有可以在 Dart 中完成的事情都可以使用 Python 库完成，但并非所有事情都有方便的包装函数。对于大多数高级用法，最好的办法是与我们联系，我们可以提供帮助。

但是，如果您想自己探索，客户端是类型良好的，因此您可以简单地浏览代码以查看可能的内容。所有更新都将通过 dart.transact 函数进行。

例如，您可以运行类似于 update_task 的命令

from dart import (
    Dart,
    Operation,
    OperationKind,
    OperationModelKind,
    TaskUpdate,
    TransactionKind,
)

# 初始化内部客户端
dart = Dart()

# 准备更新操作
task_update = TaskUpdate(
    duid="[DUID]",
    size=5,
)
task_update_op = Operation(
    model=OperationModelKind.TASK,
    kind=OperationKind.UPDATE,
    data=task_update,
)

# 以事务方式调用操作以执行更新
response = dart.transact([task_update_op], TransactionKind.TASK_UPDATE)