Accubid MCP

MCP数据服务

提供方 Charley-Forey-AI

数据服务 stdio · 本地进程 OAuth 授权 社区 / 第三方
查看接入方式

为Accubid Anywhere提供带Trimble身份认证的API代理服务,支持数据库、项目、估算等多领域工具集成。

一句话选型结论

按资料字段整理

Accubid MCP 属于数据服务类 MCP 服务器,stdio · 本地进程,OAuth 授权,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 19 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量19暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

API代理Python本地部署身份认证数据库管理项目估算工作流自动化

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
pip install -e .

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 19 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 19 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Accubid MCP当前 19 stdio · 本地进程 本地部署 有 2026-05-17
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Charley-Forey-AI上游标注的维护方 Charley-Forey-AI
分类数据服务本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

16.9 KB
来自项目仓库与上游目录的原文,未做删改

Accubid MCP服务器

用于Accubid Anywhere API和Trimble身份验证的MCP服务器。

特性

  • Trimble身份 代表 auth:每个MCP HTTP请求都携带 Authorization: Bearer (例如,来自Agent Studio);服务器 交换 它在 id.trimble.com/oauth/token (RFC 8693)因此Accubid Anywhere会收到一个令牌 你的 CLIENT_ID
  • 域工具用于:
  • 数据库
  • 项目
  • 估计
  • 清仓
  • 变更单
  • 见解
  • 上下文
  • 工作流
  • YAML中的工具元数据和服务器功能
  • 具有重试/超时的共享API客户端
  • 内置断路器和可选速率限制的弹性
  • 通用Accubid工作流程的MCP资源和提示
  • 用于分析和一次通话数据收集的见解和上下文工具
  • 用于项目和评估准备情况的工作流包工具
  • 用于多服务器环境的可选命名空间工具别名
  • 具有稳定错误代码和请求ID的结构化响应信封
  • 运行时丰富的工具发现元数据(required_params, optional_params,别名信息)

身份验证(Trimble Agent Studio)

  1. 注册一个OAuth应用程序 在 Trimble开发人员控制台 和 代币交换(代表) 启用和 Accubid任何地方 订阅了该应用程序。
  2. 复制 .env.example 到 .env 并设置 CLIENT_ID, CLIENT_SECRET,以及 ACCUBID_SCOPE (默认值 openid accubid_agentic_ai --与您的邮递员授权保持一致 scope= 调试时)。
  3. 使用以下命令运行MCP 可流式传输HTTP (python -m src.main --http 或 accubid-mcp-http). 工作室 没有每个请求的HTTP标头;如果没有参与者,工具就会失败。
  4. 连接来源 代理工作室 因此每个MCP请求包括 Authorization: Bearer (代表演员)。服务器在以下位置交换该令牌 POST {issuer}/oauth/token 和 grant_type=urn:ietf:params:oauth:grant-type:token-exchange 并将返回的访问令牌用于Accubid API调用。

邮递员 授权码 代币直接发放到您的应用程序;MCP路径使用 代币兑换 相反。两者都应该针对 相同 CLIENT_ID 并且兼容 范围 Accubid接受出境持票人。

直接服务URL(POC/临时)

如果 cloud.api.trimble.com 回报 900909 因为 控制台代理 需要API产品订阅,并且 AI代理工作室 如果上下文无法满足此要求,Accubid可能会指示您致电 直接微服务 开发主机(例如。 https://anywhereservices.trimbleplatform.net/...)直到Identity/Console提供了一种支持的方式来代表令牌使用公共代理。

以...为背景 .env:

  • ACCUBID_USE_DIRECT_SERVICES=true
  • ACCUBID_DIRECT_PLATFORM_HOST=https://anywhereservices.trimbleplatform.net (如果未设置,则默认)

MCP按区域建立服务根(databaseservice, projectservice, estimateservice[/v2], closeoutservice, changeorderservice).列出数据库映射 /databases → /Databases 以匹配直接的OpenAPI。可选的 ACCUBID_DIRECT_*_SERVICE_URL var覆盖单个碱基。

还原到代理URL (ACCUBID_USE_DIRECT_SERVICES=false)一旦Trimble权限得到解决,就可以进行与生产一致的行为。

设置

  1. 复制 .env.example 到 .env 并设置 CLIENT_ID, CLIENT_SECRET, ACCUBID_SCOPE.
  2. 安装依赖项:```bash
    pip install -e .

对于本地开发(测试、lint、打字):```bash
pip install -e ".[dev]"

授权码(邮递员)与代币兑换(MCP)

流程 发生了什么
授权代码 (邮递员) 用户同意;Trimble发布访问令牌 直接 为您 client_id.
代币兑换 (此MCP) MCP发送 演员JWT 作为 subject_token;Trimble返回a 新 访问令牌 CLIENT_ID 范围从 ACCUBID_SCOPE.

调试: 集 ACCUBID_DEBUG_LOG_OUTBOUND_TOKEN=true 简要地;比较出境JWT azp 到你的邮差令牌。在以下情况下,两者都应该是您订阅的应用程序 CLIENT_ID 比赛。

跑

  • 工作室:```bash
    python -m src.main

- HTTP:```bash
python -m src.main --http

HTTP脚本入口点:```bash
accubid-mcp-http


## MCP资源

服务器公开只读资源:

- `accubid://databases`
- `accubid://databases/{database_token}/folders`
- `accubid://databases/{database_token}/folders/{parent_folder_id}`
- `accubid://databases/{database_token}/projects`
- `accubid://databases/{database_token}/projects/{project_id}`
- `accubid://databases/{database_token}/projects/{project_id}/estimates`
- `accubid://databases/{database_token}/estimates/{estimate_id}`
- `accubid://databases/{database_token}/projects/{project_id}/contracts`
- `accubid://databases/{database_token}/contracts/{contract_id}/pcos`
- `accubid://databases/{database_token}/contracts/{contract_id}/statuses`
- `accubid://databases/{database_token}/estimates/{estimate_id}/bid-breakdown-views`
- `accubid://databases/{database_token}/bid-summaries/{bid_summary_id}/final-price`
- `accubid://context/project/{database_token}/{project_id}`
- `accubid://insights/pipeline/{database_token}/{start_date}/{end_date}`

这些资源对于轻量级的可缓存读取和上下文水合非常有用。

## MCP提示

可重复使用的提示可用于指导工作流程:

- `bid_discovery`
- `closeout_for_estimate`
- `changeorder_flow`
- `pipeline_report`
- `full_closeout_report`
- `changeorder_summary_by_project`
- `bid_risk_triage`
- `margin_review`
- `pco_exposure`
- `create_estimate_from_csv`

## 工作流程和分析

其他工具提供分析和上下文聚合,而不需要新的
Accubid端点:

- 洞察力:
- `get_pipeline_summary`
- `get_closeout_summary`
- `get_changeorder_summary`
- 背景:
- `get_project_context`
- `get_estimate_context`
- 工作流程:
- `get_project_health_packet`
- `get_estimate_readiness_packet`
- `create_estimate_from_csv_url`
- 分析:
- `analyze_bids_due_window`
- `analyze_estimate_pricing`
- `analyze_changeorder_exposure`

推荐的工作流程链:

1. 管道报告:
- `list_databases` -> `get_pipeline_summary`
1. 收尾报告:
- `get_estimate` -> `get_closeout_summary` -> `get_bid_breakdown` (可选)
1. 变更单摘要:
- `list_contracts` -> `get_changeorder_summary`
1. 项目健康包:
- `list_databases` -> `list_projects` -> `get_project_health_packet`
1. 估计准备就绪包:
- `get_estimate` -> `get_estimate_readiness_packet`
1. 投标日分流:
- `list_databases` -> `analyze_bids_due_window`
1. 定价异常检查:
- `get_estimate` -> `analyze_estimate_pricing`
1. 变更单风险:
- `list_contracts` -> `analyze_changeorder_exposure`
1. 估计进口行动:
- `list_databases` -> `create_estimate_from_csv_url` (dry_run=true,然后dry_run=false)
- 可选安全旋钮: `project_name_override`, `project_number_override`,以及 `on_project_create_failure="lookup_existing"`
- 演示的快速路径: `allow_create_project=false` 当项目已存在时

### 分析工作流演示提示

在Agent Studio中使用以下内容作为对话起点:

1. “我正在为投标日做准备。看看我们在未来14天内到期的估计,告诉我哪些有风险,以及为什么——错过定价、错过细分,或者只是没有时间了。把它们排成红色/黄色/绿色,告诉我谁先打电话。”
1. “提取项目\[名称\]的最新估算,并进行利润和成本组合审查。标记任何看起来有问题的地方——缺失的组件、劳动力组合异常值、可疑的总计——并给我一份300美分的执行摘要,我可以将其粘贴到状态电子邮件中。”
1. “给我一个项目\[名称\]的变更单风险汇总:风险总金额、最古老的未结PCO、要追逐的最高合同,以及我本周应该采取的下一步行动。”
1. 从此CSV URL创建新的估算。首先运行模拟预览,然后创建任何不重复的内容,并返回创建的项目和估算ID

CSV模板:

- `docs/samples/create_estimate_import_template.csv`

演示前沙盒检查:```bash
ACCUBID_ACTOR_TOKEN="" python scripts/sandbox_audit.py

所有三个流程的定时排练:```bash
ACCUBID_ACTOR_TOKEN="" python scripts/demo_rehearsal.py


## 工具使用流程

对于大多数任务,按以下顺序调用工具:

1. `list_databases` ->得到 `databaseToken`
1. `list_projects` ->得到 `projectID`
1. `list_estimates` ->得到 `estimateID`
1. 使用带有先前步骤ID的收尾/变更单工具

数据库令牌和项目ID是稳定的,可以缓存。

许多列表样式工具支持可选的客户端分页:

- `page_index` (基于0)
- `page_size`

列表回复包括 `pagination` 带有对象 `page_index`, `page_size`,
`total_count`, `total_pages`,以及 `has_next_page`.

大容量列表工具现在还支持可选的查询整形:

- `search` (文本搜索)
- `sort_by` (每个工具的字段别名)
- `sort_direction` (`asc` 或 `desc`)
- `status` (适用于相关的变更单列表工具)

示例:```bash
list_projects(database_token="...", search="tower", sort_by="name", sort_direction="asc")
list_estimates(database_token="...", project_id="...", search="phase", sort_by="due_date", sort_direction="desc")
list_pcos(database_token="...", contract_id="...", status="Open", sort_by="number", sort_direction="asc")

估算截止日期工作流的日期输入接受以下任一方式 yyyymmdd,
YYYY-MM-DD,或 MM/DD/YYYY 并在内部进行标准化。

响应合同

所有工具都返回一个一致的信封:```json
{
"ok": true,
"request_id": "uuid",
"data": {}
}


错误:```json
{
"ok": false,
"request_id": "uuid",
"error": {
"code": "validation_error",
"message": "..."
}
}

常见错误代码包括 validation_error, auth_failed, api_error, dependency_unhealthy,以及 internal_error.
当API断路器打开时,错误代码 circuit_open 返回。

操作手册

  • Accubid 401 / 900909 或“订阅无效”:以开头 解锁成功的Accubid呼叫 (路径A-C)。
  • 验证基础运行状况:
  • GET /health 在HTTP模式下。
  • 验证依赖关系准备就绪:
  • GET /ready 在HTTP模式下。
  • 可选依赖元数据:
  • 集 HEALTHCHECK_VERIFY_DEPENDENCIES=true 拥有 /health 包括结构化检查(env在导入时进行验证;实时Accubid调用仍然需要为每个请求提供一个actor Bearer)。
  • 启动检查:
  • 集 STARTUP_VALIDATE_DEPENDENCIES=true 在启动时运行依赖性检查。
  • 集 STARTUP_VALIDATE_ACCUBID=true 请注意,Accubid API验证需要具有参与者令牌的可流化HTTP(请参阅检查有效负载)。
  • JSON日志:
  • 集 LOG_FORMAT=json.
  • 重新调整:
  • ACCUBID_CLIENT_RETRY_COUNT
  • ACCUBID_CLIENT_RETRY_BASE_SECONDS
  • ACCUBID_CLIENT_RETRY_MAX_SECONDS
  • ACCUBID_CLIENT_RETRYABLE_STATUS_CODES
  • 断路器:
  • ACCUBID_CIRCUIT_BREAKER_FAILURES
  • ACCUBID_CIRCUIT_BREAKER_COOLDOWN_SECONDS
  • 可选API速率限制:
  • ACCUBID_RATE_LIMIT_RPS (0禁用)
  • 标准列表分页默认值:
  • ACCUBID_LIST_DEFAULT_PAGE_SIZE
  • ACCUBID_LIST_MAX_PAGE_SIZE
  • 用于发现终结点的可选短期缓存:
  • ACCUBID_CACHE_ENABLED
  • ACCUBID_CACHE_TTL_SECONDS
  • ACCUBID_CACHE_STATE_FILE (可选持久缓存状态文件路径)
  • 可选工具名称间距:
  • 集 ACCUBID_TOOL_NAMESPACE=accubid 暴露别名,如 accubid/list_projects.
  • 可选响应密钥规范化:
  • 集 ACCUBID_RESPONSE_SNAKE_CASE=true 将工具响应密钥转换为snakecase。
  • 请求相关性:
  • 设置请求标头 X-Request-Id (或配置 REQUEST_ID_HEADER)因此日志和信封共享相关性ID。
  • 韵律学:
  • 集 ENABLE_METRICS=true 并刮擦 GET /metrics (或 METRICS_ROUTE).
  • 域功能标志:
  • ACCUBID_TOOLS_DISABLE_DATABASE
  • ACCUBID_TOOLS_DISABLE_PROJECT
  • ACCUBID_TOOLS_DISABLE_ESTIMATE
  • ACCUBID_TOOLS_DISABLE_CLOSEOUT
  • ACCUBID_TOOLS_DISABLE_CHANGEORDER
  • 组合工具性能调优:
  • ACCUBID_COMPOSED_TOOL_CONCURRENCY (默认值 4)
  • 可选的持久化电路状态文件路径:
  • ACCUBID_CIRCUIT_STATE_FILE
  • Accubid Anywhere HTTP基础和每个模块路径:请求使用 ACCUBID_API_BASE_URL (默认值 https://cloud.api.trimble.com/anywhere)加上 /{area}/{version} 以及记录的路径段——例如 GET .../database/v1/databases, .../project/v2/Folders/{databaseToken}, .../estimate/v1/Estimate/..., .../closeout/v1/BidBreakdownView/... (默认值 ACCUBID_API_VERSION_*;如果Trimble更改了模块,则覆盖)。
  • 安全生产:
  • 集 ENV=production 强制HTTPS ACCUBID_API_BASE_URL.

Trimble 900909(“订阅未激活”)故障排除

Accubid Anywhere连接 401 /故障 900909 到 OAuth客户端 在 出境 访问令牌(JWT声明 azp),不仅仅是URL拼写错误。

清单

  1. client_id 平等 --邮递员 client_id 必须相等 CLIENT_ID 在 .env.
  2. 作用域(最常见的修复) --令牌交换发送 ACCUBID_SCOPE 前往Trimble。如果 outbound_scope_claim 错误只是 accubid_agentic_ai 但邮递员的代币是有效的,你的邮递员 授权URL 几乎可以肯定包括额外的范围(例如。 anywhere-database, anywhere-project, …).复制 scope= 从Postman查询值到 ACCUBID_SCOPE (空格分开,与邮递员相同)。REST端点,例如 GET .../database/v1/databases 通常需要 anywhere-database 在访问令牌中,不仅 accubid_agentic_ai.
  3. 开发者控制台 --For CLIENT_ID:启用相同 Accubid Anywhere API产品 /与Postman中的范围相同,以及 代币交换(代表)更换后重新启动MCP ACCUBID_SCOPE (缓存键包括作用域)。
  4. 仍然失败? --联系方式 Trimble支架 与JWT合作 azp / scope 工具错误详细信息。

如果 outbound_azp 已经等于你的 CLIENT_ID (代币兑换成功)但你仍然得到900909,这是 不 MCP接线错误-这是该客户与API路线的范围或产品订阅。

如果 outbound_scope_claim 已经包括 anywhere-database 你仍然会得到900909: MCP正在交换并请求正确的范围。邮递员使用 授权码;Agent Studio使用 代币兑换Trimble的Accubid网关可能适用 不同的订阅规则 对于这两种补助金类型。

不设置 ACCUBID_TOKEN_EXCHANGE_RESOURCE 或 ACCUBID_TOKEN_EXCHANGE_AUDIENCE. Trimble Identity为以下两种情况返回HTTP 400: resource / audience 此IDP明确拒绝的参数令牌交换请求可能仅包括 grant_type, subject_token, subject_token_type,以及 scope (加上您的客户端身份验证)。

如果Postman使用相同的工具 CLIENT_ID 但Agent Studio+MCP仍然可以 900909 和 anywhere-database 在出站令牌上打开 Trimble支架 case:问这个 Accubid Anywhere数据库API 权利适用于 RFC 8693令牌交换 访问OAuth应用程序的令牌,并从以下位置附加解码的JWT 授权码 (邮递员)vs token_exchange (aud, azp, scope)时间戳为900909。

MCP 交换 Agent Studio参与者令牌使用 CLIENT_ID / CLIENT_SECRETAccubid应该看到 azp =更换后的MCP应用程序。工具错误包括 actor_azp / actor_sub (入站JWT的未经验证的解码)用于诊断。

安全注意事项

  • 永不承诺 .env, CLIENT_ID,或 CLIENT_SECRET.
  • 更喜欢在生产中通过安全的秘密管理器注入秘密。
  • 对于HTTP模式,部署在反向代理/负载均衡器后面,该均衡器终止TLS并强制执行访问控制和速率限制。
  • 如果引入了面向浏览器的流量,请在反向代理/应用程序边缘配置CORS策略。
  • 旋转 CLIENT_SECRET 定期。

质量门

合并前运行:```bash
python -m ruff check .
python -m mypy src
python -m pytest
python -m pip_audit


可选的实时集成检查:```bash
ACCUBID_INTEGRATION=1 pytest -m integration

故障排除

  • auth_failed:验证 CLIENT_ID, CLIENT_SECRET, ACCUBID_SCOPE,以及 OPENID_CONFIGURATION_URL.
  • api_error 429/503:调整重试/断路器设置并检查上游API运行状况。
  • api_error 有效载荷主体缺少细节:为了安全起见,长上游有效载荷被故意截断。
  • circuit_open:等待冷却或减少故障情况;检查API/网络状态。
  • 超时:增加 ACCUBID_REQUEST_TIMEOUT_SECONDS 并验证网络可达性。
  • ViewModel工具失败:确保 connection_id 是有效的,并且来自现有的ViewModel会话(MCP不创建ViewModel会话)。

迁移说明

如果您从早期版本升级:

  • 使用dev-extras重新安装以获取新的质量工具:
  • pip install -e ".[dev]"
  • 查看新的可选环境变量:
  • ACCUBID_CACHE_STATE_FILE
  • ACCUBID_CIRCUIT_STATE_FILE
  • ACCUBID_COMPOSED_TOOL_CONCURRENCY
  • 如果维护外部工具元数据快照,请刷新它们:
  • list_available_tools 现在返回运行时丰富的元数据字段。

备注

  • Accubid需要Accubid Anywhere Manager中的API数据访问权限。
  • 基于ViewModel的扩展端点作为触发器工具公开,并需要有效的 connection_id.

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Accubid MCP 怎么安装?

在客户端按下面的安装命令接入:pip install -e .。装完在客户端配置里引用同一个包或端点。

Accubid MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Accubid MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Accubid MCP 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Accubid MCP 能提供哪些能力?

资料显示约 19 个工具;能力标签包括 API代理、工作流自动化、Python、数据分析。具体工具清单以官方文档为准。

Accubid MCP 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Accubid MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。