Analytixus

Analytixus MCP 服务

Analytixus 是一个由元数据驱动的开发平台，围绕 DnAML（数据与分析标记语言）构建——你只需对数据源、转换和文档建模一次，即可从这个统一模型生成 SQL、管道和文档，而不必手动维护它们。

此 MCP 服务向任何兼容 MCP 的客户端公开 Analytixus DnAML 仓库，例如 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 工具，请将解压后的 Analytixus.Mcp 可执行文件的完整路径用作 command。）

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 扩展

这些扩展独立管理各自的 MCP 服务列表，不受 VS Code 内置 mcp.json 管理。 打开各扩展的 MCP 设置，添加服务条目，其中 command: analytixus-mcp、 args: ["--stdio"]，以及与上文相同的 env 变量。

Claude Code（命令行）

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——它是 JSON-RPC 通道）。

了解更多

访问 analytixus.de 了解有关 Analytixus 平台的更多信息。