adios MCP server

ADIOS2 BP5 MCP服务器

该项目提供了一个模型上下文协议（MCP）服务器，用于与ADIOS2 BP5文件进行交互。它允许像Claude Desktop或自定义代理这样的LLM客户端检查元数据、读取数据切片，并理解以BP5格式存储的科学数据集的内容。

特性

• 列出变量：发现BP5文件中的所有变量，包括它们的类型、形状和可用步骤。
• 描述变量：获取任何变量的详细分解信息，显示每个步骤的块级统计数据（最小/最大）。
• 读取数据：从任何变量读取数据，支持切片维度和选择特定步骤。
• 检查属性：列出并读取全局和变量特定的属性。
• 双重运输：支持两者 stdio 用于本地集成（例如，Claude Desktop）和流媒体 HTTP 基于网络的客户端接口。

安装

建议使用 uv 用于管理Python环境。

1. 克隆存储库：

   git clone https://github.com/your-username/adios2-mcp-server.git
   cd adios2-mcp-server

1. 创建虚拟环境并安装依赖项：

   uv venv
   source .venv/bin/activate  # On Windows, use `.venv\Scripts\activate`
   uv pip install -e .

用法

服务器可以使用两种不同的传输方式运行： stdio 或 http.

1.标准I/O（stdio）传输

这是与Claude Desktop或MCP Inspector等客户端进行本地集成的标准。

直接运行：

python src/adios_mcp_server/server.py

使用 mcp 用于开发和测试的CLI： MCP检查器是调试服务器的强大工具。

# Start the server in development mode with the MCP Inspector
mcp dev src/adios_mcp_server/server.py

# To test with a specific file:
mcp dev src/adios_mcp_server/server.py -- --file-path /path/to/your/data.bp

2.流式HTTP传输

这通过HTTP公开了服务器，允许网络客户端连接。

使用Uvicorn启动服务器：

uvicorn adios_mcp_server.server:app --host 0.0.0.0 --port 8000

MCP SSE端点将在 http://localhost:8000/。你可以用 curl:

# Example: Send an `initialize` request
curl -X POST -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","clientInfo":{"name":"curl-test"},"capabilities":{}}}' \
     http://localhost:8000/

工具参考

服务器公开了以下工具：

测试

要运行测试套件，请执行以下操作：

# Install test dependencies
pip install pytest

# Run tests
pytest tests/

这些测试创建了示例BP5文件，并验证了所有MCP工具在各种数据类型和配置下都能正常工作。

例子

示例1：基本变量检查

# List all variables in a BP5 file
result = list_variables("/path/to/simulation.bp")
print(result)

# Get detailed info about a specific variable
result = describe_variable("/path/to/simulation.bp", "temperature")
print(result)

示例2：读取数据片段

# Read full data for all steps
result = read_data("/path/to/simulation.bp", "temperature")

# Read a specific spatial slice from step 10-20
result = read_data(
    "/path/to/simulation.bp",
    "temperature",
    start=[0, 0, 50],
    count=[100, 100, 50],
    step_start=10,
    step_count=10
)

示例3：属性检查

# List all attributes
result = list_attributes("/path/to/simulation.bp")

# Read a specific attribute
result = read_attribute("/path/to/simulation.bp", "simulation_time")

配置

Claude桌面集成

要将此服务器与Claude Desktop一起使用，请将以下内容添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "adios2-bp5": {
      "command": "python",
      "args": ["/path/to/adios2-mcp-server/src/adios_mcp_server/server.py"],
      "env": {}
    }
  }
}

环境变量

您可以使用环境变量配置服务器：

• ADIOS2_MCP_LOG_LEVEL：设置日志记录级别（调试、信息、警告、错误）
• ADIOS2_MCP_MAX_ARRAY_SIZE：JSON中返回的最大数组大小（默认值：10000个元素）

贡献

1. 分叉存储库
2. 创建要素分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

致谢

• 收音机2 用于高性能I/O框架
• 模型上下文协议 对于协议规范
• FastMCP 用于高级MCP服务器框架