Ukri Gtr

@pipeworx/ukri-gtr

UKRI Gateway to Research MCP——英国七个研究理事会（EPSRC、MRC、BBSRC、NERC、ESRC、AHRC、STFC）以及 Innovate UK 授予的所有研究资助：资助对象、资助用途、金额和时间。一键免密。

属于 Pipeworx——一个连接 AI Agent 与 1684+ 个实时数据源的 MCP 网关。

工具

• gtr_search_projects(query, funder?, status?, search_field?, limit?, page?) — 对英国资助项目进行全文搜索；返回资助编号、标题、状态、资助理事会、资助类别、牵头部门和资助期限。
• gtr_get_project(project) — 通过 GtR GUID 或人工可读的资助编号（EP/T022159/1、10045762）查询单个项目。跟踪 FUND 和 LEAD_ORG 链接，返回英镑计价的资助金额、牵头机构及其地址、首席研究员，以及完整的摘要／技术摘要／潜在影响文本。
• gtr_search_organisations(name, limit?, page?) — 按名称查找获得资助的英国机构；返回机构 ID、名称、邮政编码和地区。
• gtr_organisation_projects(organisation, funder?, status?, limit?, page?) — 按机构 ID 或名称查询单个机构的资助组合。
• gtr_search_publications(query, search_field?, limit?, page?) — 搜索资助持有人报告为研究成果的期刊文章和论文；返回 DOI、PubMed ID、期刊、日期和来源项目 ID。

身份验证

无。免密且不限量——无需密钥、账户或注册。

该工具包会设置两个必需的标头：Accept: application/vnd.rcuk.gtr.json-v7（此处使用供应商提供的媒体类型；普通的 Accept: application/json 会返回错误的表示形式）和常规浏览器 User-Agent。

数据源

• API 根地址：https://gtr.ukri.org/gtr/api
• 项目：https://gtr.ukri.org/gtr/api/projects?q=cancer&s=10&p=1
• 单个项目：https://gtr.ukri.org/gtr/api/projects/{guid}
• 资助金额：https://gtr.ukri.org/gtr/api/funds/{guid}
• 机构：https://gtr.ukri.org/gtr/api/organisations?q=imperial+college&s=10&f=org.n
• 机构资助组合：https://gtr.ukri.org/gtr/api/organisations/{guid}/projects
• 研究成果出版物：https://gtr.ukri.org/gtr/api/outcomes/publications?q=cancer&s=10
• 面向公众的网站：https://gtr.ukri.org

注意事项

页大小参数 s 超出 10–100 范围时会被拒绝——s=1 返回 HTTP 400 Page size cannot be less than 10，s=200 返回 Page size cannot be greater than 100，因此该工具包会将每个请求限制在此范围内，并将结果裁剪至调用方指定的 limit。项目对象上没有奖金额：金额位于通过 links.link[] 中 rel === 'FUND' 找到的基金上，gtr_get_project 会跟进该链接（以及 LEAD_ORG 和 PI_PER），因此 Agent 询问某项拨款的金额时，只需一次调用就能得到答案——基金的 amount 合法地可能为 0。项目自身的 start 和 end 字段几乎在每条记录中都为 null（抽样的 100 条记录中有 0 条填有值），因此该工具包改为从 FUND 链接的 start/end 获取资助期限；二者都是 Unix 毫秒时间戳，并会转换为 ISO 日期。响应封装中的集合键因端点而异——project、organisation、person、fund、publication；而 links.link[] 数组庞大且对模型毫无用处，因此会从所有输出中移除，仅供内部使用。

最棘手的问题是：/projects/{guid} 永远不会返回 404。 对于未知 GUID，它会按 GUID 片段匹配，并返回 HTTP 200 以及一个完全无关的项目（00000000-0000-0000-0000-000000000000 会返回一个 id 仅包含 0000 的 BBSRC 博士生奖学金项目），因此 gtr_get_project 会将返回的 id 与请求的 id 比较，并报告 found: false，而不是针对错误的拨款作答。/organisations/{guid} 则会正确报错。搜索无匹配项时也会返回 404，错误为 Page requested exceeds maximum available: 0；该工具包会将其转换为空结果，而不是抛出异常。

GtR 没有针对资助方或状态的服务端过滤器。它的搜索会在多字段查询中遵循类似 Lucene 的 AND 逻辑，因此将文本字段与 pro.lf 配对可将结果缩小到约 95% 为纯上游匹配；该工具包会这样处理，然后在客户端精确匹配 leadFunder 和 status，最多遍历 5 个每页 100 条的上游页面，以填满所请求的 limit。大型资助组合中的匹配项在各页面分布不均，因此筛选调用返回的 found: false 会提供可继续查询的页面，而不代表这些拨款不存在。将搜索限制为单个字段时使用 f=——有效的项目字段包括 pro.t（标题）、pro.a（摘要）、pro.gr（拨款编号）、pro.lf（首席资助方）；其他任何值都会返回 HTTP 400，并指出无效字段。

组织搜索若不使用 f=org.n 就无法使用：默认的多字段搜索 imperial college 会返回吉林大学和 NYU，而限定名称字段的搜索则会返回 Imperial 的记录。接着，GtR 会将每所机构拆分成数十条重复记录——“University of Cambridge”有 40 多条记录，分别持有 6,949 / 1,547 / 305 / 163 项拨款，其中持有量最大的一条排名并非最高。因此，gtr_organisation_projects 会通过探查最多 20 个候选项的拨款数量来解析名称，保留持有量最大的记录，并将其余候选项及其数量作为 alternatives 返回。地址字段包含字面字符串 "Unknown"，而非 null，该工具包会对其进行规范化。最后，/organisations/{id}/projects 会将该机构牵头或仅参与的拨款都计入，因此某行的 lead_organisation_id 通常会指向另一个机构。标题和摘要经过 HTML 转义（Simulation & Analytics），并会被解码。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "ukri-gtr": {
      "url": "https://gateway.pipeworx.io/ukri-gtr/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/ukri-gtr/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、discover_tools、search_within、remember/recall 和网关级工具集中的其他工具。因此，你看到的工具数量会多于表格中的数量：目前，单个工具包端点除了列出自身工具外，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，并且是当天适用范围的权威说明。

这是有意为之，并非意外的多路复用。元工具让限定范围的连接也能回答本工具包未涵盖的问题——通过可跨整个目录路由的 ask_pipeworx 实现——无需再添加第二个 MCP 服务。目前无法挂载不含这些工具的工具包端点；如果额外的架构定义占用的上下文超过路由功能带来的价值，请只连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是当前工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都会连接到同一个网关和相同的 1684+ 个数据源。唯一的区别是，直接列出哪个工具包的工具；无论连接哪一个，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/gtr_search_projects \
  -H 'Content-Type: application/json' \
  -d '{"query":"quantum computing","funder":"EPSRC","status":"Active","limit":10}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/gtr_search_projects。查找工具包：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经过网关往返：

{
  "mcpServers": {
    "ukri-gtr": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-ukri-gtr"]
    }
  }
}

或者直接运行，确认它可以启动：

npx -y @pipeworx/mcp-ukri-gtr

它通过 stdin/stdout 使用 MCP 协议，并响应 initialize/tools/list/tools/call，但只提供此工具包的工具——不包含上述网关连接额外提供的共享元工具。数据源相同，工具相同，但没有 ask_pipeworx 路由功能。

使用 ask_pipeworx

你也可以用通俗英语提问，而不必直接调用工具——此功能既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Ukri Gtr data" })

网关会自动选择合适的工具并填写参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT