Analytixus

Analytixus MCP サーバー

Analytixus は、DnAML（Data and Analytics Markup Language）を中心に構築されたメタデータ駆動型の開発プラットフォームです。データソース、変換処理、ドキュメントを一度モデル化するだけで、手作業で管理する代わりに、その単一のモデルから SQL、パイプライン、ドキュメントを生成できます。

この MCP サーバーは、Analytixus の DnAML リポジトリをあらゆる MCP 対応クライアント（Claude Desktop、Cursor、VS Code Copilot Chat、ご自身のツールなど）に公開するため、AI アシスタントがメタデータモデルを直接読み書きできます。

このリポジトリには、Analytixus MCP サーバーのドキュメントと設定ガイドが含まれています。 サーバー自体は、自己完結型の実行可能ファイルと .NET ツールとして配布されています（以下を参照）。

できること

• リポジトリツリーの閲覧 — DnAML モデル内のソリューション、ソース、オブジェクトを一覧表示します。
• リポジトリの検索 — 名前や種類、または DnAML のコンテンツやセクション（列、オリジン、参照、ドキュメント、ロード、コンシューマー）からノードを検索します。検索結果には親のコンテキストが保持されます。大規模なリポジトリを扱いやすくするには、ツリーツールで maxDepth を使用してください。
• DnAML ノードの読み書き — 単一オブジェクトの定義を取得したり、ソースまたはフォルダー内にオブジェクトを作成または更新したりします。
• ソリューション管理 — 利用可能なソリューションの一覧表示、追加、名前変更、削除を行います。

インストール

オプション 1 — 自己完結型のダウンロード（ランタイム不要）。 Windows、macOS、Linux 向けのビルド済みアーカイブは、Analytixus チームにリクエストすると入手できます。

オプション 2 — .NET グローバルツール（.NET 8 ランタイムが必要です）：

dotnet tool install --global Analytixus.Mcp

これにより、analytixus-mcp コマンドがインストールされます。

設定

Claude Desktop

claude_desktop_config.json に追加します。

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "analytixus": {
      "command": "analytixus-mcp",
      "args": ["--stdio"],
      "env": {
        "ANALYTIXUS_SOLUTION_PATH": "/path/to/your/dnaml-solution",
        "ANALYTIXUS_SOLUTION_NAME": "YourSolutionName"
      }
    }
  }
}

（.NET ツールではなく自己完結型アーカイブをインストールした場合は、command として、展開した Analytixus.Mcp 実行可能ファイルのフルパスを使用してください。）

VS Code（Copilot Chat）

オプション A — MCP Servers ギャラリー経由（推奨）：

1. 拡張機能パネルを開き（Ctrl+Shift+X）、MCP Servers タブに切り替えて、Analytixus を検索し、Install + Enable をクリックします。
   VS Code はユーザーレベルの mcp.json にエントリを自動的に追加しますが、必要な環境変数はまだ設定されていません。

2. mcp.json を開き、インストールされたエントリに env キーを追加します。command、args、 gallery、version は VS Code が記述したとおりに変更せず、そのままにしてください。

   • Windows：%APPDATA%\Code\User\mcp.json
   • macOS：~/Library/Application Support/Code/User/mcp.json
   • Linux：~/.config/Code/User/mcp.json

   {
     "servers": {
       "de.analytixus/analytixus-mcp": {
         "type": "stdio",
         "command": "dnx",
         "args": ["[email protected]", "--yes"],
         "gallery": "https://api.mcp.github.com",
         "version": "0.8.5",
         "env": {
           "ANALYTIXUS_SOLUTION_PATH": "/path/to/your/dnaml-solution",
           "ANALYTIXUS_SOLUTION_NAME": "YourSolutionName"
         }
       }
     }
   }
   

   （args と version のバージョン番号は VS Code がインストールしたものを使用し、そのままにしてください。）

オプション B — 手動設定（最初に .NET グローバルツールをインストールします： dotnet tool install --global Analytixus.Mcp）：

mcp.json に追加します。

{
  "servers": {
    "analytixus": {
      "type": "stdio",
      "command": "analytixus-mcp",
      "args": ["--stdio"],
      "env": {
        "ANALYTIXUS_SOLUTION_PATH": "/path/to/your/dnaml-solution",
        "ANALYTIXUS_SOLUTION_NAME": "YourSolutionName"
      }
    }
  }
}

Roo Code / Cline / その他の VS Code AI 拡張機能

これらの拡張機能は、VS Code 組み込みの mcp.json とは別に、それぞれ独自の MCP サーバーリストを管理します。各拡張機能の MCP 設定を開き、command: analytixus-mcp、 args: ["--stdio"]、および上記と同じ env 変数を指定して、サーバーエントリを追加してください。

Claude Code（CLI）

claude mcp add --env ANALYTIXUS_SOLUTION_PATH=/path/to/your/dnaml-solution \
  --env ANALYTIXUS_SOLUTION_NAME=YourSolutionName --scope user \
  analytixus -- analytixus-mcp --stdio

環境変数

変数	用途
ANALYTIXUS_SOLUTION_PATH	DnAML ソリューションのルートフォルダーへのパスです。
ANALYTIXUS_SOLUTION_NAME	ソリューション名です。このサーバーインスタンスをそのソリューションに固定します。
ANALYTIXUS_LOG_LEVEL	Trace|Debug|Info|Warn|Error|Fatal（デフォルトは Info）です。

ツール

ツール	目的
solutions_list	登録済みのソリューション（ANALYTIXUS_SOLUTION_* が設定されている場合は、ピン留めされたもののみ）
repository_get_tree	ソリューションのリポジトリツリー。大規模なリポジトリでは、出力を制限するために maxDepth（例：1）を使用します
repository_search	名前やノードタイプでノードを検索します。親を含む階層的な結果を返します
repository_search_content	DnAML の内容（text）やセクションの有無（hasColumns、hasOrigins、hasReferences、hasDocumentation、hasLoad、hasConsumers）で検索します。一致した理由が各検索結果に示されます
repository_read_node、repository_read_node_recursive	ノード（またはすべての子孫ノードを含むノード）を DnAML または XML として読み取ります
repository_write_node	既存のノードに対する DnAML を検証して書き込みます（名前の変更を検出します）
repository_add_folder、repository_add_source、repository_add_node_under_folder、repository_add_node_under_source	フォルダー、ソース、ノードを作成します
repository_delete_node、repository_delete_folder_recursive、repository_delete_source_recursive	削除します（元に戻せません）
get_dnaml_reference	DnAML 構文リファレンス
solution_add、solution_delete、solution_rename	ソリューション管理 — サーバーが特定のソリューションにピン留めされていない場合にのみ公開されます

ログはツールと同じ階層の logs/ に書き込まれます。--stdio モードでは、stderr には Warn 以上のみが出力されます （stdout には出力されません。stdout は JSON-RPC チャネルです）。

詳細情報

Analytixus プラットフォームの詳細については、analytixus.de をご覧ください。