AI导哈

ATLAS开放数据访问服务

通过MCP协议为LLM提供ATLAS开放数据的元数据和文件检索服务，所有数据公开可访问。

  • by atlas-outreach-data-tools
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 atlas-outreach-data-tools/atlasopenmagic-mcp

使用说明

atlasopenmagic mcp

MCP服务器 ATLAS开放数据 元数据和文件检索。

此服务器包装 atlasopenmagic Python库作为 MCP（模型上下文协议） 服务器，允许LLM发现、查询和检索ATLAS开放数据集。

建筑

LLM <--MCP/stdio--> atlasopenmagic-mcp serve <--HTTPS--> ATLAS Open Data API
                                                          (atlasopenmagic-api.app.cern.ch)

无需身份验证——所有ATLAS开放数据均可公开访问。

安装

pip install atlasopenmagic-mcp

或者用pixi：

pixi install

用法

作为MCP服务器

atlasopenmagic-mcp serve

Claude桌面配置

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "atlas-open-data": {
      "command": "atlasopenmagic-mcp",
      "args": ["serve"]
    }
  }
}

可用工具

工具 说明
atlas_available_releases 列出所有可用的数据发布
atlas_set_release 为后续查询设置活动版本
atlas_get_current_release 获取当前活动版本
atlas_available_datasets 列出当前版本中的数据集编号（DSID）
atlas_available_skims 列出可用的活动短剧
atlas_available_keywords 列出发布中使用的物理关键字
atlas_get_metadata_fields 列出可用的元数据字段
atlas_get_metadata 获取数据集的元数据（无文件列表）
atlas_get_all_info 获取完整的数据集信息，包括文件URL
atlas_match_metadata 按元数据字段值搜索数据集
atlas_get_urls 使用浏览和协议选项获取文件URL
atlas_get_weights 获取数据集的MC权重元数据
atlas_get_all_weights_for_release 获取发布中所有数据集的权重

可用资源

URI 描述
atlas-open-data://guide ATLAS开放数据概念快速参考
atlas-open-data://metadata-fields 完整的元数据字段参考

发展

# Run tests
pixi run test

# Run linting
pixi run lint

# Run all checks
pixi run check-all

与atlasopenmagic保持同步

此服务器依赖于 atlasopenmagic 作为pip依赖项。当上游库更新时：

  1. 非破坏性更改 （新字段、新版本）：自动工作——MCP工具调用 atlasopenmagic 函数，因此新的数据表面没有任何变化。
  2. 新功能：添加新的工具模块或扩展现有的工具模块，在中注册 server.py.
  3. 重大变更 （重命名/删除的函数，更改的签名）：更新受影响的工具模块以匹配新的API，然后将版本引脚插入 pyproject.toml.

要取消依赖关系，请执行以下操作：

# In pyproject.toml, update:
#   "atlasopenmagic>=1.9"  →  "atlasopenmagic>=1.10"

许可证

阿帕奇-2.0

相关 MCP