项目简介

ASAM ODS Jaquel MCP 服务器是为大型语言模型（LLM）客户端设计的后端服务，专注于处理ASAM ODS (Open Data Services) 标准数据。它通过提供一系列工具、资源和交互式Prompt，帮助LLM理解、构建、验证和执行Jaquel查询，从而高效访问和分析测量数据。该服务器内置ODS连接管理，支持ODS架构检查、Jaquel查询验证、优化、调试，以及时间序列数据的批量访问和可视化脚本生成。

主要功能点

ODS连接管理: 建立、管理和关闭到ASAM ODS服务器的连接。
Jaquel查询工具: 提供29+个工具，用于ASAM ODS架构检查、查询验证、优化、调试和直接执行ODS查询。
数据访问与分析: 支持批量读取时间序列数据和子矩阵数据，自动生成Jupyter Notebook进行测量对比，以及生成Matplotlib可视化代码。
实体层级探索: 可视化实体层级结构，如AoTest到AoMeasurement。
交互式Prompt: 提供引导式工作流的交互式起始Prompt，帮助用户学习和使用API。
API学习辅助: 通过'get_bulk_api_help'工具提供AI指导的批量API学习。

安装步骤

推荐使用uvx (无需手动管理虚拟环境): 打开终端，运行命令 'uvx odsbox-jaquel-mcp'。uvx会自动安装并启动服务器。
使用pipx (持久化安装): 打开终端，运行命令 'pipx install odsbox-jaquel-mcp'。安装完成后，运行 'odsbox-jaquel-mcp' 即可启动服务器。
传统pip安装 (在虚拟环境中):
- 创建一个Python虚拟环境: 'python -m venv .venv'
- 激活虚拟环境:
  - 在Linux/macOS上: 'source .venv/bin/activate'
  - 在Windows上: '.venv\Scripts\activate'
- 安装服务器及其数据分析和可视化依赖: 'pip install odsbox-jaquel-mcp[play]'
- 在虚拟环境中运行服务器: 'python -m odsbox_jaquel_mcp'

服务器配置 (用于MCP客户端)

MCP客户端需要配置服务器的启动信息才能连接。以下是两种推荐的配置方式，选择与您的安装方式匹配的即可：

如果使用uvx安装: 在MCP客户端的配置中添加一个名为 "odsbox-jaquel" 的服务器配置。该配置将指示客户端使用 'uvx' 命令启动 'odsbox-jaquel-mcp' 服务器。
```
{
  "mcpServers": {
    "odsbox-jaquel": {
      "command": "uvx",
      "args": ["odsbox-jaquel-mcp"]
    }
  }
}
```
'command': 指定用于启动MCP服务器的可执行文件路径或命令。这里是 'uvx'。 'args': 提供给 'command' 的命令行参数列表。这里是 'odsbox-jaquel-mcp'，指示 'uvx' 运行这个包。
如果使用pipx安装: 在MCP客户端的配置中添加一个名为 "odsbox-jaquel" 的服务器配置。该配置将指示客户端直接使用 'odsbox-jaquel-mcp' 命令启动服务器。
```
{
  "mcpServers": {
    "odsbox-jaquel": {
      "command": "odsbox-jaquel-mcp"
    }
  }
}
```
'command': 指定用于启动MCP服务器的可执行文件路径或命令。这里是 'odsbox-jaquel-mcp'，即通过pipx安装后的可执行命令。 'args': 在这种情况下，没有额外的命令行参数。

基本使用方法

启动服务器: 按照上述安装步骤中的方式启动服务器 (例如 'uvx odsbox-jaquel-mcp')。服务器将在标准输入/输出上等待MCP客户端的消息。
连接MCP客户端: 配置您的MCP客户端（例如Claude Desktop或VS Code的MCP插件），使其能够连接到此服务器。配置完成后，客户端将自动建立连接。
通过LLM调用工具: 在您的LLM客户端中，您可以直接通过对话调用此服务器提供的工具。例如，您可以要求LLM "连接到ODS服务器，URL是http://localhost:8087/api，用户名为user，密码为pass"，LLM会调用'connect_ods_server'工具。
探索功能: 使用'list_tools'工具查看所有可用功能，或使用'list_prompts'获取引导式工作流的起始提示。例如，您可以要求LLM "列出所有Jaquel查询模式" 或者 "给我一个验证Jaquel查询的起始提示"。
访问资源: 您可以通过'list_resources'发现可用的参考文档，并使用'read_resource'读取其内容，例如获取ASAM ODS连接指南。

关键词

项目简介

主要功能点

安装步骤

服务器配置 (用于MCP客户端)

基本使用方法

信息