Skip to main content
Glama

🗺️ CodeAtlas MCPサーバー

AIアシスタントに、あらゆるコードベースへの深い理解を

npm CI License Node

MCPサーバー単体で、Gemini、Claude、Cursor、Windsurf、VS Code Copilotにコード分析データを提供します。会話間での永続的なAIメモリも実現します。


✨ 何ができるのか?

Your Code → CodeAtlas Analyze → MCP Server → AI Understands Everything
                                     │
                              10 powerful tools:
                              • Search functions & classes
                              • Trace feature flows
                              • Generate architecture diagrams
                              • Persistent memory across conversations

CodeAtlas導入前: AIは盲目的にgrepを行い、会話のたびにプロジェクトを忘れてしまいます。 CodeAtlas導入後: AIはアーキテクチャや依存関係を即座に把握し、コンテキストを記憶します。


Related MCP server: Codebase MCP Server

🚀 セットアップ(1分)

1. プロジェクトを分析する

CodeAtlas拡張機能をインストールし、以下を実行します:

Ctrl+Shift+P → CodeAtlas: Analyze Project

2. AIにMCP設定を追加する

{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "@giauphan/codeatlas-mcp"]
    }
  }
}
{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "@giauphan/codeatlas-mcp"]
    }
  }
}
{
  "mcp": {
    "servers": {
      "codeatlas": {
        "command": "npx",
        "args": ["-y", "@giauphan/codeatlas-mcp"]
      }
    }
  }
}
{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "@giauphan/codeatlas-mcp"]
    }
  }
}
claude mcp add codeatlas -- npx -y @giauphan/codeatlas-mcp
{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "@giauphan/codeatlas-mcp"]
    }
  }
}

完了です! これでAIは10個のCodeAtlasツールすべてを使用できるようになります。


🛠️ 10個のMCPツール

コード分析 (6ツール)

ツール

説明

使用例

list_projects

分析済みプロジェクトの一覧表示

「どんなプロジェクトがある?」

get_project_structure

モジュール、クラス、関数の取得

「クラスをすべて見せて」

get_dependencies

インポート/呼び出し/包含関係

「UserServiceは何に依存している?」

get_insights

コード品質とセキュリティ分析

「セキュリティ上の問題はある?」

search_entities

名前によるエンティティのあいまい検索

「ログイン関数を探して」

get_file_entities

特定ファイル内の全エンティティ

「auth.tsには何がある?」

アーキテクチャ可視化 (2ツール)

ツール

説明

使用例

generate_system_flow

Mermaidアーキテクチャ図 (モジュールインポート)

「システムアーキテクチャを見せて」

generate_feature_flow_diagram

Mermaid実行フロー図 (呼び出しチェーン)

「決済機能はどう動く?」

AIメモリ (2ツール)

ツール

説明

使用例

sync_system_memory

コンテキストを .agents/memory/ に保存

「変更内容を覚えておいて」

trace_feature_flow

コードベースを通じた機能の追跡

「認証にはどのファイルが関わっている?」


🧠 AIメモリ — 永続的なコンテキスト

AIアシスタントは会話のたびにすべてを忘れてしまいます。CodeAtlasはこれを解決します:

Conversation 1 → AI analyzes code → sync_system_memory
                                          │
                                   .agents/memory/
                                   ├── system-map.md       ← Architecture diagram
                                   ├── modules.json        ← All entities
                                   ├── conventions.md      ← Code patterns
                                   ├── business-rules.json ← Domain logic
                                   ├── feature-flows.json  ← Feature traces
                                   └── change-log.json     ← Change history
                                          │
Conversation 2 → AI reads memory → full context restored instantly ✨

自動生成されるIDEルール

Analyze Projectを実行すると、CodeAtlasはAI IDE用のルールファイルを自動作成します:

生成ファイル

対象

.agents/rules/codeatlas-mcp.md

すべてのAIアシスタント

.cursor/rules/codeatlas.mdc

Cursor

CLAUDE.md

Claude Code

.windsurfrules

Windsurf

これらはAIに対して以下を指示します:

  1. 会話の開始時に .agents/memory/ を読み込む

  2. 変更を加える前にMCPツールを使用する

  3. 変更完了後に sync_system_memory を呼び出す


🌍 対応言語

言語

機能

TypeScript / JavaScript

完全なAST: インポート、クラス、関数、変数、呼び出し、実装

Python

クラス、関数、変数、インポート、呼び出し

PHP

クラス、インターフェース、トレイト、列挙型、関数、プロパティ

Blade Templates

@extends, @include, @component, <x-component>


📦 代替案: グローバルインストール

npm install -g @giauphan/codeatlas-mcp

その後、MCP設定で "command": "codeatlas-mcp" を使用します(argsは不要です)。


🔧 環境変数

変数

説明

CODEATLAS_PROJECT_DIR

特定のプロジェクトディレクトリを強制指定

デフォルトでは、サーバーは ~/ 配下にある .codeatlas/analysis.json を持つすべてのプロジェクトを自動検出します。


🧑💻 開発

git clone https://github.com/giauphan/codeatlas-mcp.git
cd codeatlas-mcp
npm install
npm run build
npm test    # 6 tests
npm start   # Start MCP server

🔗 関連リンク

ライセンス

MIT — 個人利用および商用利用は無料です。

A
license - permissive license
A
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

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

  • A
    license
    Not graded
    quality
    A
    maintenance
    A Model Context Protocol server that enhances AI agents by providing deep semantic understanding of codebases, enabling more intelligent interactions through advanced code search and contextual awareness.
    88
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol server that analyzes application codebases with real-time file watching, providing AI assistants like Claude with deep insights into project structure, code patterns, and architecture.
    MIT

View all related MCP servers

Related MCP Connectors

  • Give your AI agent a persistent map of your project's structure, dependencies, and bugs.

  • A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

  • Deterministic context layer for your codebase: change impact, blast radius, answers with receipts.

View all MCP Connectors

Latest Blog Posts

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/giauphan/codeatlas-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server