Openvds MCP Server

OpenVDS MCP服务器

MCP（模型上下文协议）服务器，通过自然语言查询实现人工智能辅助访问Bluware OpenVDS地震和体积数据。

概述

该MCP服务器将大规模体积数据集（地震调查、地球物理数据）与Claude等人工智能系统连接起来，实现了：

• 自然语言数据发现：使用简明英语查询调查
• 智能数据提取：人工智能辅助切片和体积提取
• 元数据分析：自动化调查统计和质量评估
• 比较分析：交叉调查比较和时间监测

特性

真正的OpenVDS集成✅

所有数据访问都使用实际的OpenVDS Python API：

• 真正的VDS文件打开 openvds.open()
• 使用OpenVDS布局描述符进行实际元数据提取
• 使用以下方法提取真实数据 requestVolumeSubset() 使用NumPy数组
• 根据实际地震振幅数据计算统计数据
• 演示模式仅在没有VDS文件可用时作为回退

MCP资源

• 调查元数据目录（从真实的VDS文件中提取）
• 服务器功能信息
• 数据结构文档

MCP工具

• extract_inline：使用OpenVDS从地震勘测中提取内联切片
• extract_crossline：使用OpenVDS提取交叉线切片
• extract_volume_subset：使用OpenVDS提取体积子集
• get_survey_info：从VDS文件中获取详细的调查元数据
• list_available_surveys：列出所有可用的调查并进行筛选

MCP提示

• survey_discovery：查找符合特定标准的调查
• data_quality_check：分析调查的数据质量
• extract_seismic_section：提取特定地震剖面
• compare_surveys：比较调查之间的特征

安装

macOS用户（推荐：Docker）

OpenVDS Python滚轮不适用于macOS。 在macOS上运行此服务器的最简单方法是使用Docker：

1. 安装

1. 构建Docker镜像:

   ./run-docker.sh

1. 配置Claude桌面 -请参阅 医生.md 有关完整的设置说明

📖 完整的Docker指南: 医生.md

Linux/Windows用户

需求

• Python 3.11+
• OpenVDS Python SDK（可通过Linux/Windows上的pip获得）
• MCP-SDK

设置

1. 安装依赖项：

pip install mcp openvds anthropic pydantic aiohttp

1. 在MCP客户端设置中配置服务器（例如，Claude Desktop config.json):

{
  "mcpServers": {
    "openvds": {
      "command": "python",
      "args": ["src/openvds_mcp_server.py"],
      "env": {
        "VDS_DATA_PATH": "/path/to/vds/files"
      }
    }
  }
}

1. 运行服务器：

python src/openvds_mcp_server.py

用法

演示模式（仅回退）

服务器以演示模式运行 仅当未找到VDS文件时演示模式返回模拟响应，用于在没有真实数据的情况下测试MCP协议。

使用真实的VDS文件（生产使用）

使用真正的OpenVDS数据提取，设置 VDS_DATA_PATH 指向VDS数据目录的环境变量：

export VDS_DATA_PATH="/data/seismic:/data/surveys"
python src/openvds_mcp_server.py

服务器将：

1. 扫描所有 .vds 指定路径中的文件
2. 使用OpenVDS布局API提取真实元数据
3. 提供具有真实振幅统计的实际数据提取
4. 根据实际地震数据计算质量指标

备注：如果没有真正的VDS文件，您可以测试MCP协议，但无法获得实际的地震数据。

查询示例

发现调查：

"Show me all 3D seismic surveys acquired in the Gulf of Mexico after 2023"

提取数据：

"Extract inline 2500 from the Gulf of Mexico 2023 survey"

数据质量：

"Analyze the data quality of the North Sea survey and identify any issues"

比较调查：

"Compare the Permian Basin 2022 survey with the Gulf of Mexico 2023 survey"

建筑

OpenVDS MCP Server
├── src/openvds_mcp_server.py  # Main MCP server implementation
├── src/vds_client.py           # OpenVDS integration layer
├── config.json                 # MCP client configuration
└── README.md                   # Documentation

关键组件

服务器层(openvds_mcp_server.py)

实现MCP协议处理程序：

• 资源列表和阅读
• 工具执行
• 提示模板

VDS客户端层(vds_client.py)

提供OpenVDS集成：

• 调查发现和元数据提取
• 数据切片提取
• 统计和质量分析
• 测试演示模式

用例

• 数据发现：可用地震调查的自然语言查询
• 智能提取：人工智能辅助选择数据切片和卷
• 质量控制：自动化数据质量评估
• 报告生成：自动调查摘要报告
• ML工作流集成：为机器学习模型准备训练数据集
• 协作：面向非技术利益相关者的自然语言界面

安全考虑

• 企业部署的身份验证和授权
• 大数据请求的速率限制
• 安全处理云存储凭据
• 数据访问的审计跟踪

未来的增强功能

• 企业部署的OAuth身份验证
• 高级可视化集成
• 批处理能力
• 格式转换工具（SEG-Y等）
• 云存储集成（S3、Azure Blob）
• 用于频繁访问数据的缓存层

贡献

这是一个概念验证，展示了MCP与地球物理数据的集成。欢迎投稿！

许可证

MIT许可证-有关详细信息，请参阅许可证文件

参考文献

• 模型上下文协议
• OpenVDS文档
• Bluware VDS