atlas-mcp-server
ATLAS: タスク管理システム
ATLAS (Adaptive Task & Logic Automation System) は、LLM エージェント用のプロジェクト、知識、およびタスク管理システムです。
3 層アーキテクチャ上に構築されています:
+------------------------------------------+
| PROJECT |
|------------------------------------------|
| id: string |
| name: string |
| description: string |
| status: string |
| urls?: Array<{title: string, url: string}>|
| completionRequirements: string |
| outputFormat: string |
| taskType: string |
| createdAt: string |
| updatedAt: string |
+----------------+-------------------------+
| |
| |
v v
+----------------------------------+ +----------------------------------+
| TASK | | KNOWLEDGE |
|----------------------------------| |----------------------------------|
| id: string | | id: string |
| projectId: string | | projectId: string |
| title: string | | text: string |
| description: string | | tags?: string[] |
| priority: string | | domain: string |
| status: string | | citations?: string[] |
| assignedTo?: string | | createdAt: string |
| urls?: Array<{title: string, | | |
| url: string}> | | updatedAt: string |
| tags?: string[] | | |
| completionRequirements: string | | |
| outputFormat: string | | |
| taskType: string | | |
| createdAt: string | | |
| updatedAt: string | | |
+----------------------------------+ +----------------------------------+モデル コンテキスト プロトコル (MCP) サーバーとして実装された ATLAS により、LLM エージェントはプロジェクト管理データベースと対話して、プロジェクト、タスク、および知識項目を管理できるようになります。
重要なバージョンノート:バージョン1.5.4は、データベースとしてSQLiteを使用する最後のバージョンです。バージョン2.0以降は、Neo4jを使用するように完全に書き換えられました。Neo4jを使用するには、次のいずれかが必要です。
Docker を使用したセルフホスティング (リポジトリに docker-compose が含まれています)
Neo4j AuraDB クラウド サービスの使用: https://neo4j.com/product/auradb/
バージョン 2.5.0 では、以前の構造に代わる新しい 3 ノード システム (プロジェクト、タスク、ナレッジ) が導入されています。
目次
Related MCP server: TaskFlow MCP
概要
ATLAS はモデルコンテキストプロトコル (MCP) を実装し、以下を通じて LLM と外部システム間の標準化された通信を可能にします。
クライアント: Claude Desktop、IDE、およびその他の MCP 互換クライアント
サーバー: プロジェクト、タスク、知識管理のためのツールとリソース
LLMエージェント:サーバーの管理機能を活用するAIモデル
システム統合
Atlas プラットフォームは、次のコンポーネントを 1 つの統合システムに統合します。
プロジェクトとタスクの関係:プロジェクトには、プロジェクトの目標を達成するために必要な実行可能なステップを表すタスクが含まれます。タスクは親プロジェクトのコンテキストを継承しながら、個々の作業項目をきめ細かく追跡できます。
知識の統合: プロジェクトとタスクの両方に知識項目を追加して、チーム メンバーに必要な情報とコンテキストを提供できます。
依存関係管理: プロジェクトとタスクの両方が依存関係をサポートし、前提条件と順次実行要件を含む複雑なワークフローを可能にします。
統合検索: プラットフォームはエンティティ間の検索機能を提供し、ユーザーはさまざまな基準に基づいて関連するプロジェクト、タスク、または知識を見つけることができます。
特徴
プロジェクト管理
**包括的な追跡:**一括操作の組み込みサポートを使用して、プロジェクトのメタデータ、ステータス、リッチ コンテンツ (メモ、リンクなど) を管理します。
**依存関係と関係の処理:**プロジェクト間の依存関係を自動的に検証および追跡します。
タスク管理
**タスク ライフサイクル管理:**タスクのライフサイクル全体にわたってタスクを作成、追跡、更新します。
**優先順位付けと分類:**優先順位を割り当て、タグを使用してタスクを分類し、整理しやすくします。
**依存関係の追跡:**タスクの依存関係を確立して、構造化されたワークフローを作成します。
ナレッジマネジメント
**構造化された知識リポジトリ:**プロジェクト関連情報の検索可能なリポジトリを維持します。
**ドメイン分類:**知識をドメインとタグ別に整理し、簡単に検索できるようにします。
**引用サポート:**ナレッジ項目のソースと参照を追跡します。
グラフデータベース統合
**ネイティブ リレーションシップ管理:**堅牢なデータ整合性を実現するために、Neo4j の ACID 準拠のトランザクションと最適化されたクエリを活用します。
**高度な検索とスケーラビリティ:**高いパフォーマンスを維持しながら、あいまい一致とワイルドカードを使用してプロパティベースの検索を実行します。
統合検索
**クロスエンティティ検索:**コンテンツ、メタデータ、または関係に基づいて、関連するプロジェクト、タスク、またはナレッジを検索します。
**柔軟なクエリ オプション:**大文字と小文字を区別しない、あいまい、および高度なフィルタリング オプションをサポートします。
インストール
リポジトリをクローンします。
git clone https://github.com/cyanheads/atlas-mcp-server.git cd atlas-mcp-server依存関係をインストールします:
npm installNeo4jの設定: Neo4jインスタンスが実行中でアクセス可能であることを確認してください。提供されているDocker設定を使用してインスタンスを起動できます。
docker-compose up -dNeo4j 接続の詳細を使用して
.envファイルを更新します (構成を参照)。プロジェクトをビルドします。
npm run build
サーバーの実行
ほとんどの MCP クライアントはサーバーを自動的に実行しますが、次のコマンドを使用してテストまたは開発の目的で手動で実行することもできます。
ATLAS MCP サーバーは、通信用の複数のトランスポート メカニズムをサポートしています。
**標準 I/O (stdio):**これはデフォルトのモードで、通常はローカル MCP クライアント (IDE 拡張機能など) との直接統合に使用されます。
npm run start:stdioこれは
MCP_TRANSPORT_TYPE=stdio設定を使用します。**ストリーミング可能な HTTP:**このモードでは、サーバーは HTTP 経由で MCP 要求をリッスンできるため、リモート クライアントや Web ベースの統合に適しています。
npm run start:httpMCP_TRANSPORT_TYPE=http設定を使用します。サーバーは.envファイルで定義されたホストとポート(例:MCP_HTTP_HOSTとMCP_HTTP_PORT、デフォルトは127.0.0.1:3010)でリッスンします。リモートアクセスする場合は、ファイアウォールで接続が許可されていることを確認してください。
Web UI(実験的)
プロジェクト、タスク、ナレッジの詳細を表示するための基本的な Web UI が利用できます。
UIを開く:
ブラウザで UI を直接開くには、ターミナルで次のコマンドを実行します。
npm run webui
機能性:
Web UI のスクリーンショットの例は、こちらでご覧いただけます。
構成
環境変数
環境変数は、MCP クライアントのクライアント構成、またはローカル開発の場合はプロジェクト ルートの.envファイルで設定する必要があります。
# Neo4j Configuration
NEO4J_URI=bolt://localhost:7687
NEO4J_USER=neo4j
NEO4J_PASSWORD=password2
# Application Configuration
MCP_LOG_LEVEL=debug # Minimum logging level. Options: emerg, alert, crit, error, warning, notice, info, debug. Default: "debug".
LOGS_DIR=./logs # Directory for log files. Default: "./logs" in project root.
NODE_ENV=development # 'development' or 'production'. Default: "development".
# MCP Transport Configuration
MCP_TRANSPORT_TYPE=stdio # 'stdio' or 'http'. Default: "stdio".
MCP_HTTP_HOST=127.0.0.1 # Host for HTTP transport. Default: "127.0.0.1".
MCP_HTTP_PORT=3010 # Port for HTTP transport. Default: 3010.
# MCP_ALLOWED_ORIGINS=http://localhost:someport,https://your-client.com # Optional: Comma-separated list of allowed origins for HTTP CORS.
# MCP Security Configuration
# MCP_AUTH_SECRET_KEY=your_very_long_and_secure_secret_key_min_32_chars # Optional: Secret key (min 32 chars) for JWT authentication if HTTP transport is used. CRITICAL for production. *Note: Production environment use has not been tested yet.*
MCP_RATE_LIMIT_WINDOW_MS=60000 # Rate limit window in milliseconds. Default: 60000 (1 minute).
MCP_RATE_LIMIT_MAX_REQUESTS=100 # Max requests per window per IP for HTTP transport. Default: 100.
# Database Backup Configuration
BACKUP_MAX_COUNT=10 # Maximum number of backup sets to keep. Default: 10.
BACKUP_FILE_DIR=./atlas-backups # Directory where backup files will be stored (relative to project root). Default: "./atlas-backups".
# OpenRouter LLM Configuration (Optional - additional parameters present in `src/config/index.ts`)
# OPENROUTER_API_KEY=your_openrouter_api_key # API key for OpenRouter services.
LLM_DEFAULT_MODEL="google/gemini-2.5-flash-preview:thinking" # Default LLM model.使用可能なすべての環境変数、その説明、およびデフォルト値については、 src/config/index.tsを参照してください。
MCPクライアント設定
MCPクライアントの設定方法は、クライアント自体と選択したトランスポートタイプによって異なります。プロジェクトルートにあるmcp.jsonファイルは、一部のクライアント( mcp-inspectorなど)でサーバー設定を定義するために使用できます。必要に応じて更新してください。
Stdio トランスポートの場合 (構成例):
{
"mcpServers": {
"atlas-mcp-server-stdio": {
"command": "node",
"args": ["/full/path/to/atlas-mcp-server/dist/index.js"],
"env": {
"NEO4J_URI": "bolt://localhost:7687",
"NEO4J_USER": "neo4j",
"NEO4J_PASSWORD": "password2",
"MCP_LOG_LEVEL": "info",
"NODE_ENV": "production",
"MCP_TRANSPORT_TYPE": "stdio"
}
}
}
}**ストリーミング可能な HTTP の場合 (構成例):**クライアントがストリーミング可能な HTTP 経由での MCP サーバーへの接続をサポートしている場合は、クライアント構成でサーバーのエンドポイント (例: http://localhost:3010/mcp ) を指定します。
{
"mcpServers": {
"atlas-mcp-server-http": {
"command": "node",
"args": ["/full/path/to/atlas-mcp-server/dist/index.js"],
"env": {
"NEO4J_URI": "bolt://localhost:7687",
"NEO4J_USER": "neo4j",
"NEO4J_PASSWORD": "password2",
"MCP_LOG_LEVEL": "info",
"NODE_ENV": "production",
"MCP_TRANSPORT_TYPE": "http",
"MCP_HTTP_PORT": "3010",
"MCP_HTTP_HOST": "127.0.0.1"
// "MCP_AUTH_SECRET_KEY": "your-secure-token" // If authentication is enabled on the server
}
}
}
}**注:**サーバーがクライアントの直下の作業ディレクトリにない場合は、クライアントコマンドを設定する際にargsに必ず絶対パスを使用してください。クライアントのenvブロック内のMCP_AUTH_SECRET_KEYあくまでも一例です。クライアントとサーバー間の通信における実際のトークン処理は、クライアントの機能とサーバーの認証メカニズム(例: AuthorizationヘッダーでJWTを送信するなど)によって異なります。
プロジェクト構造
コードベースはモジュール構造に従います。
src/
├── config/ # Configuration management (index.ts)
├── index.ts # Main server entry point
├── mcp/ # MCP server implementation (server.ts)
│ ├── resources/ # MCP resource handlers (index.ts, types.ts, knowledge/, projects/, tasks/)
│ └── tools/ # MCP tool handlers (individual tool directories)
├── services/ # Core application services
│ ├── llm-providers/ # LLM provider integrations (e.g., OpenRouter)
│ └── neo4j/ # Neo4j database services (index.ts, driver.ts, backupRestoreService.ts, etc.)
├── types/ # Shared TypeScript type definitions (errors.ts, mcp.ts, tool.ts)
└── utils/ # Utility functions and internal services (e.g., logger, errorHandler, sanitization)ツール
ATLAS は、モデル コンテキスト プロトコルを介して呼び出すことができる、プロジェクト、タスク、および知識管理用の包括的なツール スイートを提供します。
プロジェクト運営
ツール名 | 説明 | 主な議論 |
| 新しいプロジェクトを作成します (単一/一括)。 |
|
| プロジェクトを一覧表示します (すべて/詳細)。 |
|
| 既存のプロジェクトを更新します (単一/一括)。 |
|
| プロジェクトを削除します (単一/一括)。 |
|
タスク操作
ツール名 | 説明 | 主な議論 |
| 新しいタスクを作成します (単一/一括)。 |
|
| 既存のタスクを更新します (単一/一括)。 |
|
| タスクを削除します (単一/一括)。 |
|
| 特定のプロジェクトのタスクを一覧表示します。 |
|
知識オペレーション
ツール名 | 説明 | 主な議論 |
| 新しいナレッジ項目を追加します (単一/一括)。 |
|
| ナレッジ アイテムを削除します (単一/一括)。 |
|
| 特定のプロジェクトのナレッジ項目を一覧表示します。 |
|
捜索活動
ツール名 | 説明 | 主な議論 |
| エンティティ全体で統合検索を実行します。 |
|
研究業務
ツール名 | 説明 | 主な議論 |
| Atlas ナレッジ ベース内に階層的な計画を作成し、構造化された詳細な調査プロセスを開始します。 |
|
データベース操作
ツール名 | 説明 | 主な議論 |
| **破壊的:**データベースを完全にリセットし、すべてのプロジェクト、タスク、ナレッジを削除します。 |
|
リソース
ATLAS は、標準の MCP リソース エンドポイントを通じてプロジェクト、タスク、および知識データを公開します。
直接リソース
リソース名 | 説明 |
| ページ区切りをサポートする Atlas プラットフォーム内のすべてのプロジェクトのリスト。 |
| ページ区切りとフィルタリングをサポートする Atlas プラットフォーム内のすべてのタスクのリスト。 |
| ページ区切りとフィルタリングをサポートする Atlas プラットフォーム内のすべてのナレッジ アイテムのリスト。 |
リソーステンプレート
リソース名 | 説明 |
| 一意の識別子 ( |
| 一意の識別子 ( |
| 特定のプロジェクト ( |
| 一意の識別子 ( |
| 特定のプロジェクト ( |
データベースのバックアップと復元
ATLASは、Neo4jデータベースのコンテンツをバックアップおよび復元する機能を提供します。コアロジックはsrc/services/neo4j/backupRestoreService.tsにあります。
バックアッププロセス
メカニズム:バックアッププロセスでは、すべての
Project、Task、Knowledgeノードとその関係が、別々のJSONファイルにエクスポートされます。また、すべてのデータを含むfull-export.jsonファイルも作成されます。出力: 各バックアップは、設定されたバックアップパス(デフォルト:
./atlas-backups/)内にタイムスタンプ付きのディレクトリ(例:atlas-backup-YYYYMMDDHHMMSS)を作成します。このディレクトリには、projects.json、tasks.json、knowledge.json、relationships.json、full-export.jsonが含まれます。手動バックアップ: 提供されているスクリプトを使用して手動バックアップをトリガーできます。
npm run db:backupこのコマンドは、
exportDatabase関数を呼び出すscripts/db-backup.tsを実行します。
復元プロセス
メカニズム:復元プロセスはまず、既存のNeo4jデータベースを完全にクリアします。次に、指定されたバックアップディレクトリにあるJSONファイルからノードとリレーションシップをインポートします。full
full-export.json利用可能な場合は、それが優先されます。警告:バックアップからの復元は破壊的な操作です。Neo4jデータベース内の現在のデータはすべて上書きされます。
手動復元: バックアップ ディレクトリからデータベースを復元するには、インポート スクリプトを使用します。
npm run db:import <path_to_backup_directory><path_to_backup_directory>実際のバックアップフォルダへのパス(例:./atlas-backups/atlas-backup-20250326120000atlas-backup-20250326120000)に置き換えます。このコマンドは、importDatabase関数を呼び出すscripts/db-import.tsを実行します。リレーションシップの処理:インポートプロセスでは、エクスポート時にノードに保存された
idプロパティに基づいてリレーションシップを再構築しようとします。リレーションシップを正しく復元するには、ノードのidプロパティが一貫していることを確認してください。
例
examples/ディレクトリには、ATLAS MCP サーバーのさまざまな機能を示す実用的な例が含まれています。
バックアップ例:
examples/backup-example/にあるこの例は、npm run db:backupコマンドによって生成されるJSONファイルの構造と形式を示しています。詳細については、例のREADMEをご覧ください。Deep Research の例:
examples/deep-research-example/にあるこの例は、atlas_deep_researchツールによって生成された出力と構造を示しています。研究計画の概要を示すマークダウンファイル (covington_community_grant_research.md) と、研究計画作成後にデータベースからエクスポートされた生データを含む JSON ファイル (full-export.json) が含まれています。詳細については、例の README をご覧ください。
ライセンス
Apacheライセンス2.0
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- FlicenseNot gradedqualityFmaintenanceThis server implements the Model Context Protocol to facilitate meaningful interaction and understanding development between humans and AI through structured tools and progressive interaction patterns.57
- -licenseAqualityNot gradedmaintenanceA task management Model Context Protocol server that helps break down user requests into manageable tasks with subtasks, dependencies, and notes, while enforcing a structured workflow with user approval steps.173510
- AlicenseBqualityDmaintenanceA Model Context Protocol server providing AI assistants with comprehensive project, task, and subtask management capabilities with project-specific storage.293988MIT
- AlicenseNot gradedqualityDmaintenanceModel Context Protocol server that standardizes tool discovery, execution, and context management for AI applications.MIT
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
AI Reasoning Cache & Consensus Layer with 11 MCP tools via Streamable HTTP.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
Appeared in Searches
- A scheduling engine powered by AI
- A server for data engineering tasks, GPU clustering, nomad setup, and data pipeline management
- A system for task management and integration with AI editors using multiple LLMs
- Tools and Templates for Prompt Management and Workflow Automation
- Information or resources related to 'Prompt'
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/cyanheads/atlas-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server