用途
Procore MCP Server 是一个 MCP（Model Context Protocol）服务器，旨在将 Procore 的完整 REST API 暴露给 AI 助手（如 Claude Desktop、Claude Code 以及任何兼容 MCP 的客户端）。它让 AI 能够直接与 Procore 的建筑项目管理功能交互，例如项目、RFI、提交文件、每日日志、预算等。该项目由 TylerIlunga 开发，初衷是帮助其使用 Procore 的土木工程师女友。
主要能力
- 完整 API 覆盖：构建时解析 Procore 的 OpenAPI 规范（约 54MB，包含 3,155 个操作），生成紧凑的目录文件（data/catalog.json）以及每个端点的详细文件（data/endpoint-details/）。
- 自动生成工具：为每个 API 操作生成一个命名的 MCP 工具，共 2,929 个（合并了同一路径的旧版本重复项）。每个工具带有结构化描述，说明其作用对象、何时使用、需要先解析哪些父级 ID、返回内容以及失败方式。已弃用的端点会在描述中标注日落日期，并在标题中标记 (Deprecated)。
- 两种工具模式：默认仅暴露 7 个发现工具，所有 Procore 端点通过
procore_api_call访问；也可通过设置PROCORE_TOOL_MODE=all注册每个端点的专用工具，但会生成约 4.7MB（约 120 万 token）的工具定义，超出当前任何模型的上下文窗口，因此为可选模式。两种模式的 API 覆盖完全相同，仅广告的工具列表大小不同。 - 认证与令牌管理：运行
npm run auth一次即可在浏览器中完成 OAuth 流程，令牌保存到~/.procore-mcp/tokens.json，过期后自动刷新。 - 运行时处理：MCP 服务器加载目录并注册工具；当 AI 助手调用工具时，服务器将其映射到正确的 Procore API 端点，注入认证头，处理速率限制和分页，并返回响应。
使用方式
- 前置条件：需要 Procore 开发者门户账户；创建一个 OAuth 应用，授权类型为 Authorization Code，重定向 URI 设置为
http://localhost。 - 配置环境：复制示例环境文件并填入凭据。
- 获取 OpenAPI 规范：需要将 Procore 的 OpenAPI 规范文件放置在
specs/combined_OAS.json。该文件因体积（约 54MB）未包含在仓库中，可从 Procore 的 API 文档获取。 - 构建与编译：运行构建目录和编译 TypeScript 的命令（具体命令未在资料中提供）。
- 认证：运行
npm run auth打开浏览器完成 OAuth。 - 启动服务器：运行启动命令（具体命令未在资料中提供）。
- 客户端配置：
- Claude Desktop：在配置文件（
~/Library/Application Support/Claude/claude_desktop_config.json）中添加服务器配置。 - Claude Code：在项目根目录的
.mcp.json中添加配置。
- Claude Desktop：在配置文件（
适用场景
适用于需要让 AI 助手直接操作 Procore 建筑项目管理数据的场景，例如通过自然语言查询项目信息、创建或更新 RFI、管理提交文件、记录每日日志、查看预算等。特别适合建筑工程师、项目经理等日常使用 Procore 的专业人员。
限制
- 需要 Procore 开发者账户和 OAuth 应用，配置有一定门槛。
- 需要手动获取并放置约 54MB 的 OpenAPI 规范文件。
- 默认模式下 AI 需要通过
procore_api_call间接调用端点，可能不如专用工具直观。 - 全量工具模式会生成超出模型上下文窗口的工具定义，实际不可用。
- 交互式
/oauth/*端点未注册为工具，但可通过procore_api_call访问。 - 具体构建、启动命令以及环境变量细节在资料中未完整提供。
