🚀 ATLAS MCP サーバードキュメント

ATLAS は、モデルコンテキストプロトコル（Model Context Protocol）に基づいて構築されたプラットフォームです。プロジェクトの管理、タスク処理、知識の保存に役立つ強力なツールエコシステムを提供します。

🚀 クイックスタート

インストールと実行

依存関係のインストール

必要なすべての依存関係を npm でインストールします。

npm install

サービスの起動

ATLAS サーバーを起動します。

npm run dev

http://localhost:3001 にアクセスしてドキュメントを確認します。

✨ 主な機能

プロジェクト管理ツール

新しいプロジェクトの作成

atlas_create_project ツールを使用して新しいプロジェクトを作成します。

npm run create-project

プロジェクトの削除

指定されたプロジェクトを削除するツールです。

npm run delete-project

タスク処理ツール

タスクの作成

atlas_create_task を使用して新しいタスクを作成します。

npm run create-task

タスクの状態を更新

タスクの状態を更新するツールです。

npm run update-task-status

知識管理ツール

知識項目の追加

新しい知識項目を追加するツールです。

npm run add-knowledge

知識ベースの検索

知識ベースを検索するツールです。

npm run search-knowledge

🔧 技術詳細

プロジェクト構造

核心ディレクトリ構造

atlas-mcp-server/
├── src/                 # ソースコードディレクトリ
│   ├── services/       # ビジネスロジックサービス
│   └── routes/         # API ルート
└── package.json        # パッケージ管理ファイル

重要なサービス

• src/services/neo4j/driver.ts：Neo4j データベース接続ドライバー。
• src/services/neo4j/backupRestoreService.ts：データベースのバックアップと復元サービス。

データモデル

エンティティ関係図

Project
├── Task
└── Knowledge

データストレージ

ATLAS は、グラフデータベースとして Neo4j を使用しています。すべてのプロジェクト、タスク、および知識項目はノードとして保存され、関係を通じて複雑なネットワーク構造を形成します。

データアクセスインターフェイス

REST API

すべてのプロジェクトを取得

GET /api/projects

新しいプロジェクトを作成

POST /api/projects
Content-Type: application/json

{
  "name": "新しいプロジェクト",
  "description": "プロジェクトの説明"
}

WebSocket インターフェイス

プロジェクトの状態をリアルタイムで更新します。

const socket = io('http://localhost:3001');
socket.on('project_updated', (data) => {
  console.log('プロジェクトが更新されました:', data);
});

データの永続化

すべてのデータ変更は自動的に保存操作をトリガーし、データの整合性を保証します。

データのバックアップと復元

自動バックアップの説明

注意： 自動バックアップ機能は削除されました。バックアップが必要な場合は、手動バックアップ手順を使用してください。

手動バックアップ手順

npm run db:backup

このコマンドは scripts/db-backup.ts スクリプトを実行し、exportDatabase 関数を呼び出してデータをエクスポートします。

データの復元手順

復元警告

データの復元は破壊的な操作であり、現在のデータベースの内容を上書きします。慎重に操作してください！

手動復元手順

npm run db:import <バックアップディレクトリのパス>

例：

npm run db:import ./atlas-backups/atlas-backup-20250326120000

リソース

直接リソース

関係リソース

• プロジェクトとタスク：/api/projects/{projectId}/tasks
• プロジェクトと知識項目：/api/projects/{projectId}/knowledge

💻 使用例

基本的な使用法

新しいプロジェクトを作成し、タスクを追加します。

npm run create-project --name "新しいプロジェクト" --description "プロジェクトの説明"
npm run create-task --project-id <projectId> --title "新しいタスク"

📚 ドキュメント

一般的なエラーコード

• 400：無効なリクエストパラメータ
• 401：認証されていないアクセス
• 500：サーバー内部エラー

エラーログ

すべてのエラー情報は src/logs/error.log ファイルに記録され、問題のトラブルシューティングが容易になります。

セキュリティに関する注意事項

認証と承認

すべての機密操作は JWT 認証を通じて行われ、権限管理ポリシーが実施されます。

データの暗号化

転送中のデータは HTTPS で暗号化され、データのセキュリティが確保されます。

ドキュメントの拡張

詳細情報を確認するには、公式ドキュメント を参照してください。

まとめ

ATLAS は強力なツールセットと柔軟な API インターフェイスを提供し、プロジェクト、タスク、および知識の効率的な管理を支援します。簡単なコマンドで複雑なデータ操作を実行でき、データのセキュリティと永続性が保証されます。開発や運用のどちらにおいても、ATLAS はあなたの信頼できるパートナーです！