使用说明
OSDU MCP服务器
通过自然语言对OSDU地下数据进行人工智能访问。
使人工智能助手能够通过对话界面与OSDU（开放地下数据宇宙）平台进行交互。通过自然语言搜索数据、管理模式、处理记录和维护合规性。
为什么选择OSDU MCP服务器？
将复杂的OSDU API工作流转换为简单的对话：
之前：
curl -X POST https://osdu.com/api/search/v2/query \
-H "Authorization: Bearer $TOKEN" \
-d '{"kind":"osdu:wks:master-data--Well:*"}'
# ... parse JSON, check schemas, format records, handle ACLs ...
之后：
You: "Find all wells in the North Sea and show their schemas"
AI: ✅ Found 247 wells
📋 Retrieved schema requirements
🎯 Ready to work with the data
主要特点
| 特性 | 描述 |
|---|---|
| 自然语言 | 通过对话进行复杂的API调用和Elasticsearch查询 |
| 多云认证 | Azure、AWS和GCP，无需配置凭据发现 |
| 31 MCP工具 | 完整的OSDU API覆盖范围（存储、搜索、架构、法律、分区） |
| 模板驱动 | 预构建的模板消除了格式猜测错误 |
| 安全控制 | 写入/删除保护、确认要求、审计日志 |
| 资源和提示 | 引导式工作流程和交互式示例 |
快速开始
设置
mcp add osdu-mcp-server -- uvx osdu-mcp-server \
-e OSDU_MCP_SERVER_URL=https://your-osdu.com \
-e OSDU_MCP_SERVER_DATA_PARTITION=opendes \
-e AZURE_CLIENT_ID=your-client-id \
-e AZURE_TENANT_ID=your-tenant-id
或者手动添加到MCP配置中：
{
"mcpServers": {
"osdu-mcp-server": {
"command": "uvx",
"args": ["osdu-mcp-server"],
"env": {
"OSDU_MCP_SERVER_URL": "https://your-osdu.com",
"OSDU_MCP_SERVER_DATA_PARTITION": "opendes",
"AZURE_CLIENT_ID": "your-client-id",
"AZURE_TENANT_ID": "your-tenant-id"
}
}
}
}
注： 身份验证凭据（Azure/AWS/GCP）是从您的环境中自动发现的。看 入门指南 对于所有身份验证方法。
试试看
“检查我的OSDU平台的运行状况”
“列出系统中可用的所有架构”
“在北海地区找井”
“显示合法标签模板”
包含什么
31工具 在6个OSDU服务中：
- 核心 -健康检查和用户权限
- 分区 -列出、获取、创建、更新和删除分区
- 法律 -通过搜索和批量操作完成合法标签管理
- 模式 -模式发现、搜索和管理
- 搜索 -Elasticsearch查询和记录发现
- 存储 -具有版本控制和批处理支持的完整CRUD操作
3提示 对于引导式工作流程：
- 能力概述和快速启动
- 使用Elasticsearch示例的搜索模式指南
- 完整的记录生命周期工作流
4资源 使用工作模板：
- 法律标签模板
- 记录结构示例
- ACL格式模式
- 搜索查询模式
配置
必需
OSDU_MCP_SERVER_URL-您的OSDU平台URLOSDU_MCP_SERVER_DATA_PARTITION-数据分区ID
可选的
OSDU_MCP_SERVER_DOMAIN-ACL的数据域（默认值：contoso.com)OSDU_MCP_ENABLE_WRITE_MODE-启用创建/更新（默认值：false)OSDU_MCP_ENABLE_DELETE_MODE-启用删除/清除（默认值：false)
许可证
Apache许可证2.0-请参阅 许可证 了解详情。
