使用说明

项目简介

Dart MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，它作为 Dart 项目管理工具与大型语言模型 (LLM) 客户端之间的桥梁，使得 LLM 能够理解和操作 Dart 中的任务和文档等信息。通过这个服务器，你可以让 AI 助手直接与你的 Dart 项目进行交互，实现智能化的项目管理。

主要功能点

Prompt 模板 (Prompts): 预置了 'create-task', 'create-doc', 'summarize-tasks' 等 Prompt，方便 LLM 快速执行创建任务、创建文档和总结任务等常见操作。
资源 (Resources): 支持 'dart-config:', 'dart-task:///{taskId}', 'dart-doc:///{docId}' 等资源模板，允许 LLM 获取 Dart 配置信息、特定任务和文档的详细信息。
工具 (Tools): 提供了丰富的工具集，包括任务管理 (如 'get_config', 'list_tasks', 'create_task', 'get_task', 'update_task', 'delete_task') 和文档管理 (如 'list_docs', 'create_doc', 'get_doc', 'update_doc', 'delete_doc')，使 LLM 能够调用 Dart 的各项功能。

安装步骤

本 MCP 服务器可以通过 'npx' 或 Docker 两种方式安装和运行。

方式一：使用 npx (推荐)

安装 Claude Desktop (如果需要): 如果你的 LLM 客户端是 Claude Desktop，请先安装 Claude Desktop。
安装 npx (如果需要): 通常 Node.js 自带 'npx'，如果未安装请先安装 Node.js。
获取 Dart 认证 Token: 登录 Dart Web App，在个人设置 (Settings) -> 账户 (Account) 中复制你的认证 Token。
配置 Claude Desktop: 打开 Claude Desktop 的设置 (Settings) -> 开发者 (Developer) -> 编辑配置 (Edit Config)，将以下 JSON 配置添加到 'claude_desktop_config.json' 文件中的 'mcpServers' 字段中。

方式二：使用 Docker

安装 Claude Desktop (如果需要): 如果你的 LLM 客户端是 Claude Desktop，请先安装 Claude Desktop。
安装 Docker: 安装 Docker Desktop。
构建 Docker 镜像: 在仓库根目录下，执行命令 'docker build -t mcp/dart .' 构建 Docker 镜像。
获取 Dart 认证 Token: 登录 Dart Web App，在个人设置 (Settings) -> 账户 (Account) 中复制你的认证 Token。
配置 Claude Desktop: 打开 Claude Desktop 的设置 (Settings) -> 开发者 (Developer) -> 编辑配置 (Edit Config)，将以下 JSON 配置添加到 'claude_desktop_config.json' 文件中的 'mcpServers' 字段中。

服务器配置

配置 Claude Desktop (以 Claude Desktop 为例)

根据你选择的安装方式，将以下 JSON 配置添加到 Claude Desktop 的 'claude_desktop_config.json' 文件中。你需要将 '"DART_TOKEN"' 的值替换为你之前获取的 Dart 认证 Token。

使用 npx 的配置:

{
  "mcpServers": {
    "dart": {
      "command": "npx",
      "args": ["-y", "dart-mcp-server"],
      "env": {
        "DART_TOKEN": "dsa_..."  // 替换为你的 Dart 认证 Token
      }
    }
  }
}

使用 Docker 的配置:

{
  "mcpServers": {
    "dart": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "DART_TOKEN", "mcp/dart"],
      "env": {
        "DART_TOKEN": "dsa_..."  // 替换为你的 Dart 认证 Token
      }
    }
  }
}

配置说明:

'"dart"': MCP 服务器的名称，可以自定义。
'"command"': 启动 MCP 服务器的命令，'npx' 方式为 '"npx"'，Docker 方式为 '"docker"'。
'"args"': 命令参数，'npx' 方式为 '["-y", "dart-mcp-server"]'，Docker 方式为 '["run", "-i", "--rm", "-e", "DART_TOKEN", "mcp/dart"]'。
'"env"': 环境变量，'"DART_TOKEN"' 用于传递 Dart 认证 Token。

基本使用方法

配置完成后，在 Claude Desktop 或其他 MCP 客户端中，你就可以选择 "dart" 这个 MCP 服务器，并开始使用预定义的 Prompts 和 Tools 与你的 Dart 项目进行交互了。例如，你可以使用 'create-task' Prompt 创建新的任务，或者使用 'list_tasks' Tool 查询任务列表。具体工具和 Prompt 的使用方法请参考 Dart MCP Server 的功能介绍。

关键词