Dart MCP Server

chính thức

Tương tác với dữ liệu tác vụ, tài liệu và dự án trong Dart, một công cụ quản lý dự án AI-native

GitHub
128

Tài liệu

Máy chủ MCP Dart

NPM License

Dart là công cụ Quản lý Dự án được hỗ trợ bởi AI.

[!WARNING] Máy chủ MCP cục bộ của Dart đã bị loại bỏ để nhường chỗ cho máy chủ MCP Dart được lưu trữ đơn giản và cải tiến hơn, bạn có thể cấu hình theo hướng dẫn này.

Thông tin đã lỗi thời `dart-mcp-server` là máy chủ AI chính thức [Model Context Protocol (MCP)](https://github.com/modelcontextprotocol) dành cho Dart.

Tính năng

Lời nhắc

Các lời nhắc sau đây có sẵn

  • create-task - Tạo một tác vụ mới trong Dart với tiêu đề, mô tả, trạng thái, mức ưu tiên và người được giao
  • create-doc - Tạo một tài liệu mới trong Dart với tiêu đề, nội dung văn bản và thư mục
  • summarize-tasks - Nhận tóm tắt các tác vụ với khả năng lọc tùy chọn theo trạng thái và người được giao

Những lời nhắc này giúp các trợ lý AI dễ dàng thực hiện các hành động phổ biến trong Dart mà không cần hiểu chi tiết API cơ bản.

Mẫu tài nguyên

Các tài nguyên sau đây có sẵn

  • dart-config: - Thông tin cấu hình về không gian của người dùng
  • dart-task:///{taskId} - Thông tin chi tiết về các tác vụ cụ thể
  • dart-doc:///{docId} - Thông tin chi tiết về các tài liệu cụ thể

Công cụ

Các công cụ sau đây có sẵn

Quản lý tác vụ

  • get_config - Nhận thông tin về không gian của người dùng, bao gồm người được giao, bảng dart, thư mục, trạng thái, thẻ, mức ưu tiên và kích thước có sẵn
  • list_tasks - Liệt kê các tác vụ với khả năng lọc tùy chọn theo người được giao, trạng thái, bảng dart, mức ưu tiên, ngày đến hạn và hơn thế nữa
  • create_task - Tạo một tác vụ mới với tiêu đề, mô tả, trạng thái, mức ưu tiên, kích thước, ngày tháng, bảng dart, người được giao, thẻ và tác vụ cha
  • get_task - Truy xuất một tác vụ hiện có theo ID của nó
  • update_task - Cập nhật các thuộc tính của một tác vụ hiện có
  • delete_task - Di chuyển một tác vụ vào thùng rác (có thể khôi phục)
  • add_task_comment - Thêm bình luận vào một tác vụ hiện có

Quản lý tài liệu

  • list_docs - Liệt kê các tài liệu với khả năng lọc tùy chọn theo thư mục, tiêu đề, nội dung văn bản và hơn thế nữa
  • create_doc - Tạo một tài liệu mới với tiêu đề, nội dung văn bản và thư mục
  • get_doc - Truy xuất một tài liệu hiện có theo ID của nó
  • update_doc - Cập nhật các thuộc tính của một tài liệu hiện có
  • delete_doc - Di chuyển một tài liệu vào thùng rác (có thể khôi phục)

Mỗi công cụ đều hỗ trợ xác thực đầu vào toàn diện và trả về phản hồi JSON có cấu trúc.

Thiết lập

Cách dễ nhất để chạy máy chủ MCP là với npx, nhưng cũng có sẵn thiết lập Docker.

Tìm tệp cài đặt MCP cho máy khách

Claude Desktop

  1. Cài đặt Claude Desktop nếu cần
  2. Mở tệp cấu hình bằng cách mở ứng dụng Claude Desktop, vào Cài đặt, mở tab 'Developer' và nhấp vào nút 'Edit Config'
  3. Làm theo các bước 'Thiết lập máy chủ MCP' bên dưới

Claude Code

  1. Cài đặt Claude Code nếu cần

  2. Sao chép mã thông báo xác thực từ hồ sơ Dart của bạn

  3. Chạy lệnh sau, đảm bảo thay thế dsa... bằng mã thông báo Dart thực tế của bạn

    claude mcp add dart -e DART_TOKEN=dsa_... -- npx -y dart-mcp-server@latest

Cursor

  1. Cài đặt Cursor nếu cần
  2. Mở tệp cấu hình bằng cách mở Cursor, vào 'Cursor Settings' (không phải cài đặt IDE VSCode thông thường), mở tab 'MCP' và nhấp vào nút 'Add new global MCP server'
  3. Làm theo các bước 'Thiết lập máy chủ MCP' bên dưới

Cline

  1. Cài đặt Cline trong IDE của bạn nếu cần
  2. Mở tệp cấu hình bằng cách mở IDE của bạn, mở thanh bên Cline, nhấp vào nút biểu tượng 'MCP Servers' thứ hai từ bên trái ở trên cùng, mở tab 'Installed' và nhấp vào nút 'Configure MCP Servers'
  3. Làm theo các bước 'Thiết lập máy chủ MCP' bên dưới

Windsurf

  1. Cài đặt Windsurf nếu cần
  2. Mở tệp cấu hình bằng cách mở Windsurf, vào 'Windsurf Settings' (không phải cài đặt IDE VSCode thông thường), mở tab 'Cascade' và nhấp vào nút 'View raw config' trong phần 'Model Context Protocol (MCP) Servers'
  3. Làm theo các bước 'Thiết lập máy chủ MCP' bên dưới

Bất kỳ máy khách nào khác

  1. Tìm tệp cài đặt MCP, thường là thứ gì đó như [client]_mcp_config.json
  2. Làm theo các bước 'Thiết lập máy chủ MCP' bên dưới

Thiết lập máy chủ MCP

  1. Cài đặt npx, đi kèm với Node, nếu cần

  2. Sao chép mã thông báo xác thực từ hồ sơ Dart của bạn

  3. Thêm phần sau vào thiết lập MCP của bạn, đảm bảo thay thế dsa... bằng mã thông báo Dart thực tế của bạn

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

Biến thể: thiết lập với Docker

Nếu thiết lập npx ở trên không hoạt động tốt, chúng tôi cũng cung cấp thiết lập Docker. Làm theo hướng dẫn ở trên để tìm tệp cài đặt MCP

  1. Cài đặt Docker nếu cần

  2. Xây dựng container Docker với docker build -t mcp/dart .

  3. Sao chép mã thông báo xác thực từ hồ sơ Dart của bạn

  4. Thêm phần sau vào thiết lập MCP của bạn, đảm bảo thay thế dsa... bằng mã thông báo Dart thực tế của bạn

    {
  "mcpServers": {
    "Dart": {
      "command": "bash",
      "args": [
        "-c",
        "docker rm -f dart-mcp >/dev/null 2>&1 || true; docker run -i --rm --name dart-mcp -e DART_TOKEN mcp/dart"
      ],
      "env": {
        "DART_TOKEN": "dsa_..."
      }
    }
  }
}

Trợ giúp và Tài nguyên

Đóng góp

Chúng tôi hoan nghênh các đóng góp! Vui lòng mở một vấn đề hoặc gửi yêu cầu kéo.

Giấy phép

Dự án này được cấp phép theo Giấy phép MIT.