Dart MCP Server

<div align="center">
  <h1>Dart MCP 服务器</h1>
  <p>
    <a href="https://npmjs.com/package/dart-mcp-server"><img src="https://img.shields.io/npm/v/dart-mcp-server" alt="NPM"></a>
    <a href="LICENSE"><img src="https://img.shields.io/github/license/its-dart/dart-mcp-server" alt="License"></a>
  </p>
</div>

[Dart](https://itsdart.com?nr=1) 是由 AI 驱动的项目管理工具。

`dart-mcp-server` 是 Dart 的官方 AI [模型上下文协议 (MCP)](https://github.com/modelcontextprotocol) 服务器。

- [功能](#features)
  - [提示词](#prompts)
  - [资源模板](#resource-templates)
  - [工具](#tools)
    - [任务管理](#task-management)
    - [文档管理](#document-management)
- [设置](#setup)
  - [查找客户端的 MCP 设置文件](#find-the-mcp-settings-file-for-the-client)
    - [Claude](#claude)
    - [Cline](#cline)
    - [任何其他客户端](#any-other-client)
  - [设置 MCP 服务器](#set-up-the-mcp-server)
  - [变体：使用 Docker 设置](#variant-setup-with-docker)
- [帮助和资源](#help-and-resources)
- [贡献](#contributing)
- [许可证](#license)

## 功能

### 提示词

以下提示词可用：

- `create-task` - 在 Dart 中创建一个新任务，包含标题、描述、状态、优先级和负责人
- `create-doc` - 在 Dart 中创建一个新文档，包含标题、文本内容和文件夹
- `summarize-tasks` - 获取任务摘要，可以选择按状态和负责人进行过滤

这些提示词使 AI 助手能够轻松地在 Dart 中执行常见操作，而无需了解底层 API 细节。

### 资源模板

以下资源可用：

- `dart-config:` - 关于用户空间的配置信息
- `dart-task:///{taskId}` - 关于特定任务的详细信息
- `dart-doc:///{docId}` - 关于特定文档的详细信息

### 工具

以下工具可用：

#### 任务管理

- `get_config` - 获取关于用户空间的信息，包括可用的负责人、看板、文件夹、状态、标签、优先级和大小
- `list_tasks` - 列出任务，可以选择按负责人、状态、看板、优先级、截止日期等进行过滤
- `create_task` - 创建一个新任务，包含标题、描述、状态、优先级、大小、日期、看板、负责人、标签和父任务
- `get_task` - 通过 ID 检索现有任务
- `update_task` - 更新现有任务的属性
- `delete_task` - 将任务移动到回收站（可恢复）

#### 文档管理

- `list_docs` - 列出文档，可以选择按文件夹、标题、文本内容等进行过滤
- `create_doc` - 创建一个新文档，包含标题、文本内容和文件夹
- `get_doc` - 通过 ID 检索现有文档
- `update_doc` - 更新现有文档的属性
- `delete_doc` - 将文档移动到回收站（可恢复）

每个工具都支持全面的输入验证，并返回结构化的 JSON 响应。

## 设置

运行 MCP 服务器的最简单方法是使用 `npx`，但也提供 Docker 设置。

### 查找客户端的 MCP 设置文件

#### Claude

1. 根据需要[安装 Claude Desktop](https://claude.ai/download)
2. 打开 `claude_desktop_config.json` 文件，可以通过打开 Claude Desktop 应用程序，进入其设置，打开“开发者”选项卡，然后单击“编辑配置”按钮来找到该文件
3. 按照下面的“设置 MCP 服务器”步骤操作

#### Cline

1. 根据需要在 IDE 中[安装 Cline](https://cline.bot/)
2. 通过打开 IDE，打开 Cline 侧边栏，单击顶部从左侧数第二个“MCP 服务器”图标按钮，打开“已安装”选项卡，然后单击“配置 MCP 服务器”按钮来安装 MCP 服务器
3. 按照下面的“设置 MCP 服务器”步骤操作

#### 任何其他客户端

1. 找到 MCP 设置文件，通常为 `[client]_mcp_settings.json`
2. 按照下面的“设置 MCP 服务器”步骤操作

### 设置 MCP 服务器

1. 根据需要[安装 npx](https://nodejs.org/en/download)，它与 Node 捆绑在一起
2. 从[您的 Dart 个人资料](https://app.itsdart.com/?settings=account)复制您的身份验证令牌
3. 将以下内容添加到您的 MCP 设置中，请务必将 `dsa...` 替换为您实际的 Dart 令牌

   ```json
   {
     "mcpServers": {
       "dart": {
         "command": "npx",
         "args": ["-y", "dart-mcp-server"],
         "env": {
           "DART_TOKEN": "dsa_..."
         }
       }
     }
   }

变体：使用 Docker 设置

如果上面的 npx 设置效果不佳，我们还提供 Docker 设置。 按照上面的说明找到 MCP 设置文件

1. 根据需要安装 Docker

2. 使用 docker build -t mcp/dart . 构建 Docker 容器

3. 从您的 Dart 个人资料复制您的身份验证令牌

4. 将以下内容添加到您的 MCP 设置中，请务必将 dsa... 替换为您实际的 Dart 令牌

   {
     "mcpServers": {
       "dart": {
         "command": "docker",
         "args": ["run", "-i", "--rm", "-e", "DART_TOKEN", "mcp/dart"],
         "env": {
           "DART_TOKEN": "dsa_..."
         }
       }
     }
   }
   

帮助和资源

• 主页
• Web 应用
• 帮助中心
• 错误和功能
• 库源代码
• 在 Discord 上聊天
• 通过电子邮件联系我们：support@itsdart.com

贡献

欢迎贡献！ 请打开一个 issue 或提交一个 pull request。

许可证

本项目根据 MIT 许可证 获得许可。