DrillerDB

DrillerDB MCP 服务

面向 DrillerDB 的远程 Model Context Protocol 服务。DrillerDB 是水井和钻井承包商的操作系统。将 DrillerDB 账户连接到 Microsoft Copilot、Claude、ChatGPT、Codex、Cursor、VS Code 或任何 MCP 客户端，即可用日常语言处理实际项目、客户、发票、施工团队和水井日志。

https://mcp.drillerdb.com

传输方式	Streamable HTTP
身份验证	OAuth 2.0（Authorization Code + PKCE，Dynamic Client Registration）
托管	由 DrillerDB, LLC. 管理。无需安装或自行托管。
账户	需要有效的 DrillerDB 账户（app.drillerdb.com）
注册名称	com.drillerdb/drillerdb
完整文档	drillerdb.com/connectors/mcp

此仓库包含公开文档，以及托管式 DrillerDB MCP 服务的 server.json 注册清单。服务本身是托管服务，其源代码不开放。

---

快速开始

在 MCP 客户端中将服务 URL 添加为自定义连接器。首次使用时会自动进行 OAuth 登录，访问权限仅限于你自己的 DrillerDB 公司。

Claude Code

claude mcp add --transport http drillerdb https://mcp.drillerdb.com

Claude（网页端和桌面端）

依次前往 Settings -> Connectors -> Add custom connector，然后粘贴 https://mcp.drillerdb.com。

Microsoft Copilot

DrillerDB 正在为该服务申请 Microsoft MCP 认证。Microsoft 发布经过认证的连接器后，管理员便可从 Microsoft 的 Agent 和连接器目录中启用它。该连接器同样使用 DrillerDB OAuth 登录和公司级权限。

Gemini CLI

直接从此仓库安装 DrillerDB 扩展：

gemini extensions install https://github.com/DrillerDB/drillerdb-mcp

Gemini CLI 会从 gemini-extension.json 加载托管端点，并在你对服务进行身份验证时启动 DrillerDB OAuth 登录流程。

Cursor / VS Code / 其他客户端

{
  "mcpServers": {
    "drillerdb": {
      "type": "http",
      "url": "https://mcp.drillerdb.com"
    }
  }
}

你的客户端会通过 /.well-known/oauth-protected-resource 和 401 响应中的 WWW-Authenticate 标头自动发现 OAuth 端点，因此无需手动配置客户端 ID 或密钥。

---

你可以询问什么

• “本周有哪些项目已准备好安排进度？”
• “Acme Farms 还欠我们多少钱？欠款有多久了？”
• “给我看看 Johnson 项目的水井日志。”
• “本季度的收入进度与上一季度相比如何？”
• “哪些钻机即将需要维护？”
• “为今天的施工团队起草现场报告，并将其附加到项目中。”

---

权限范围

范围	授予权限
mcp:read	读取项目、客户、发票、提案、工单、施工团队、日程安排、现场报告、设备、工时卡、通信记录、库存和水井日志
mcp:write:low	可轻松撤销的写入操作，例如附加备注或提交现场报告
mcp:write:high	更改状态的写入操作，例如安排项目进度、派遣项目人员或发送发票
mcp:proposals:write	生成和交付提案

风险较高的写入工具需要审批：工具会先返回 approval-required 结果，只有你在 DrillerDB 控制台中批准后才会执行操作。任何联系客户或转移资金的操作都必须经过明确确认。

---

安全

• 租户隔离。 每个查询都会根据 OAuth 令牌绑定的 company_id 进行筛选，绝不会使用工具输入进行筛选。无法访问其他承包商的数据。
• 审计日志。 每次工具调用都会被记录：调用者、所用工具、调用时间和结果。
• 可撤销。 你可以随时从 DrillerDB 账户撤销连接器的访问权限，令牌会立即失效。
• 速率限制。 针对每位使用者的限制可保护服务和你的账户。
• 第一方服务。 DrillerDB 拥有 API 和数据。连接器数据不会出售，也不会用于广告。

有关数据的收集、使用和保留方式，请参阅 DrillerDB 隐私政策。

---

工具目录

读取工具（37 个）

工具	标题
ar_aging_report	应收账款账龄报告
customer_ltv_report	客户生命周期价值报告
get_communication_detail	获取通信详情
get_company_proposal_habits	获取公司提案习惯
get_compliance_form	获取合规表单
get_equipment_detail	获取设备详情
get_geology_at_location	获取指定地点的地质信息
get_invoice_detail	获取发票详情
get_job_profitability	获取项目盈利能力
get_maintenance_due	获取待维护项目
get_project_compliance_status	获取项目合规状态
get_project_detail	获取项目详情
get_project_financials	获取项目财务信息
get_proposal_detail	获取提案详情
get_quote_detail	获取报价详情
get_quote_engagement	获取报价互动情况
get_timecard_summary	获取工时卡汇总
get_work_order_detail	获取工单详情
list_communications	列出通信记录
list_contacts	列出联系人
list_crews	列出施工队
list_customers	列出客户
list_equipment	列出设备
list_field_reports	列出现场报告
list_inventory	列出库存
list_invoices	列出发票
list_my_projects	列出我的项目
list_project_files	列出项目文件
list_projects_by_customer	按客户列出项目
list_proposals	列出提案
list_timecards	列出工时卡
list_work_orders	列出工单
query_schedule	查询日程
query_well_logs	查询钻井记录
revenue_pipeline	收入管道
run_report	运行报告
total_billed_by_contact	按联系人统计开票总额

写入工具（8 个）

工具	标题	权限范围	需审批
attach_note_to_project	为项目添加备注	mcp:write:low	否
dispatch_project	派发项目	mcp:write:high	是
import_vendor_invoice	导入供应商发票	mcp:write:high	是
plan_crew_route	规划施工队路线	mcp:write:low	否
schedule_project	安排项目	mcp:write:high	是
send_invoice	发送发票	mcp:write:high	是
submit_field_report	提交现场报告	mcp:write:low	否
update_project_status	更新项目状态	mcp:write:high	是
所有工具均声明 openWorldHint: false——每个工具仅操作调用公司的 DrillerDB 租户自身数据。

---

支持

• 文档：https://drillerdb.com/connectors/mcp
• 电子邮件：[email protected]
• 关于本文档的问题：在此仓库中提交 issue。

关于 DrillerDB

DrillerDB 将项目管理、钻井记录、排期、提案、开票、设备跟踪和客户历史记录整合在一个系统中，服务于水井和钻井承包商。了解更多信息，请访问 drillerdb.com。

许可证

此仓库中的文档采用 MIT 许可证。DrillerDB 托管的 MCP 服务受 DrillerDB 服务条款约束。