Cyanheads Atlas MCP Server

🚀 ATLAS 日本語ドキュメント

ATLASは、モデルコンテキストプロトコルに基づいて構築されたタスク管理ツールです。このツールは、チームがプロジェクトタスクを効率的に組織し、追跡するのを支援することを目的としています。タスクの作成、更新、検索、およびメンテナンス機能を提供し、バッチ操作とデータベース最適化もサポートしています。

🚀 クイックスタート

ATLASを使って、タスクを効率的に管理しましょう。以下では、主な機能や操作方法を紹介します。

✨ 主な機能

• タスクの作成、更新、検索、メンテナンス機能を提供
• バッチ操作とデータベース最適化をサポート
• タスクの状態や依存関係の管理

📦 インストール

1. リポジトリをクローンします：git clone https://github.com/atlas-project.git
2. 依存関係をインストールします：make install-deps
3. コンパイルします：make build

💻 使用例

基本的な使用法

タスクの作成

create_task を使用して新しいタスクを作成する際には、パス命名規則に従い、依存関係が正しいことを確認する必要があります。

{
  "path": "project/backend", // パス命名規範に従う
  "name": "后端开发",
  "type": "GROUP",
  "description": "实现核心后端服务",
  "metadata": {
    "priority": "high",
    "tags": ["backend", "api"]
  }
}

タスクの更新

update_task を使用して既存のタスクを更新する際には、状態の変更と依存関係の検証に注意する必要があります。

{
  "path": "project/backend/api",
  "updates": {
    "status": "IN_PROGRESS", // 依存関係を検証する
    "dependencies": ["project/backend/database"],
    "metadata": {
      "progress": 50,
      "assignee": "团队成员"
    }
  }
}

バッチタスク操作

bulk_task_operations を使用して原子操作を実行し、複数のタスク変更の一貫性を確保します。

{
  "operations": [
    {
      "type": "create",
      "path": "project/frontend",
      "data": {
        "name": "前端开发",
        "type": "GROUP"
      }
    },
    {
      "type": "update",
      "path": "project/backend",
      "data": {
        "status": "COMPLETED"
      }
    }
  ]
}

タスクの検索

状態での検索

get_tasks_by_status を使用して、実行状態に基づいてタスクを検索します。

{
  "status": "IN_PROGRESS"
}

パスパターンでの検索

get_tasks_by_path を使用して、ワイルドカードパターンを使ってタスクを検索します。

{
  "pattern": "project/backend/**"
}

メンテナンスツール

データベースの最適化

vacuum_database ツールを使用して、データベースのパフォーマンスを最適化し、統計情報を更新します。

{
  "analyze": true // 同時に統計情報を更新する
}

関係の修復

repair_relationships を使用して、タスク関係の不一致を修復します。

{
  "dryRun": true, // 変更をプレビューする
  "pathPattern": "project/**"
}

タスクの削除

clear_all_tasks を使用して、データベースを完全にリセットします（操作を確認する必要があります）。

{
  "confirm": true
}

📚 ドキュメント

ベストプラクティス

タスク管理

• 階層構造を反映するために、説明的なパス名を使用する
• 適切なタスクタイプ（GROUP、TASK）を設定する
• コンテキストを提供するために、詳細な説明を含める
• カスタムフィールドを保存するために、メタデータを使用する
• 依存関係を慎重に処理する
• クリーンな親子関係を維持する

パス命名

• 英字、数字、ハイフン、およびアンダースコアを使用する
• パスを短く、意味のあるものに保つ
• パスは有効なプロジェクト名で始める
• 特殊文字の使用を避ける
• 正斜線で区切る
• 階層を5層以内に抑える

パフォーマンス最適化

• 複数の変更を処理するために、バッチ操作を使用する
• 検索パターンを簡潔かつ効率的にする
• 定期的にデータベースのメンテナンスタスクを実行する
• システムのパフォーマンス指標を監視する

既知の問題

1. パス深度の検証不足：現在のバージョンでは、パス深度の検証が不十分であり、深いネストのタスク管理が複雑になる可能性があります。
2. 連鎖削除の制限：連鎖削除機能が実装されていないため、親タスクを手動で削除する際には、子タスクを慎重に処理する必要があります。

開発ガイド

プロジェクト構造

• src/main.c：メインプログラムのエントリーポイント
• include atlas.h：コアライブラリのインターフェース
• lib/：サードパーティの依存ライブラリ
• doc/：ドキュメントとサンプル

コンパイルとインストール

1. リポジトリをクローンする：git clone https://github.com/atlas-project.git
2. 依存関係をインストールする：make install-deps
3. コンパイルする：make build

貢献ガイド

• ISSUEを提出して、問題や提案を報告する
• PRを送信して、エラーを修正したり、機能を追加したりする
• コミュニティの議論に参加する

📄 ライセンス

このプロジェクトはMITライセンスに準拠しています。詳細な条項については、LICENSE ファイルを参照してください。

以上のツールとベストプラクティスを通じて、ATLASはチームが複雑なプロジェクトのタスクを効率的に管理し、協力の効率を向上させるのに役立ちます。