Dart MCP Server 使用说明

项目简介

Dart MCP Server 是一个使用 Dart 工具进行任务、文档和工作区管理的 Model Context Protocol (MCP) 服务器。它允许大型语言模型（LLM）客户端通过标准化的 MCP 协议，调用 Dart 工具提供的各项功能，实现与 Dartboard 项目管理平台的集成。

主要功能点

任务管理: 创建、更新和管理 Dartboard 中的任务，包括设置任务标题、描述、优先级和状态。
文档管理: 创建和组织文档，支持 Markdown 内容，并能生成报告。
工作区管理: 创建和管理工作区，使用文件夹组织内容，并控制访问权限。
Dartboard 集成: 作为 Dartboard 项目管理工具的 MCP 服务端接口，方便 LLM 客户端进行任务和项目管理操作。

安装步骤

克隆仓库

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

安装 Node.js 依赖 确保已安装 Node.js 环境（推荐 16.x 或更高版本）。
```
npm install
```

设置 Python 环境和 Dart SDK 确保已安装 Python 环境（推荐 3.8 或更高版本）。

python -m venv .venv
source .venv/bin/activate  # 或在 Windows 上运行： .venv\Scripts\activate
pip install dart-sdk

配置环境变量 复制 '.env.example' 文件并重命名为 '.env'，然后根据需要编辑 '.env' 文件。
```
cp .env.example .env
vim .env
```
在 '.env' 文件中，至少需要配置 Dart API Token：
```
DART_TOKEN=your_dart_token_here
```
可选配置 Python SDK 路径 (PYTHONPATH) 和 Python 执行路径 (PYTHON_PATH)。
构建项目
```
npm run build
```

服务器配置

MCP 客户端需要配置以下 JSON 信息才能连接到 Dart MCP Server。请注意将 'path/to/dart-mcp-server' 替换为 Dart MCP Server 仓库在您本地的实际路径。

{
  "server name": "Dart MCP Server",
  "command": "node",
  "args": ["path/to/dart-mcp-server/dist/index.js"]
}

'server name': 服务器名称，可以自定义。
'command': 启动服务器的命令，这里使用 'node'。
'args': 传递给 'node' 命令的参数，指向编译后的服务器入口文件 'index.js'。

基本使用方法

启动服务器 在仓库根目录下运行以下命令启动 Dart MCP Server：
```
npm start
```
服务器成功启动后，会监听 MCP 客户端的请求。
配置 MCP 客户端 在 MCP 客户端中，根据上述 服务器配置 填写连接信息。客户端将通过 Stdio 协议与 Dart MCP Server 进行通信，并可以调用服务器提供的工具，例如 'create_task'、'update_task' 等，具体工具列表请参考仓库 README 或服务器的 'listTools' 接口。
调用工具 客户端可以使用 'callTool' 等 MCP 协议方法调用服务器提供的工具，实现对 Dartboard 任务、文档和工作区的管理操作。工具的具体参数和使用方法请参考仓库提供的文档或工具的 'inputSchema' 定义。

关键词