Uk Parliament Erskinemay

io.github.nick-ma由 GitHub 账号 nick-ma 发布v1.0.1更新于 Oct 27, 2026

MCP server for UK Parliament Erskine May API

概览

AI 生成的概览

只读的 MCP 服务器,让助手通过官方 API 查询和检索英国议会 Erskine May 议事规则内容。

可以做什么
  • 按编号获取章(chapter)与部分(part),并列出全部部分
  • 按 id、步骤或引用获取节、节概览与段落
  • 按首字母浏览索引词条,并按 id 获取单个词条
  • 按关键词检索索引词条、节与段落,支持 skip/take 分页
  • 返回结构化响应封装,并保留上游 JSON 原始内容
适用场景
适合需要权威英国议会程序依据的场景,例如回答议事程序问题、为法律或议会研究梳理节与段落,或为公民科技数据集补充 Erskine May 引用。
运行要求
以 stdio 在本地运行,通常通过 npx 启动 npm 包,需要 Node.js 以及访问 Erskine May API 的网络连接。未声明任何身份验证。可选环境变量用于设置上游基础地址、请求超时,以及 HTTP 代理模式下的本地端口。
安装前请注意
所有工具都是针对公开议会 API 的只读查询与检索,查询内容会发送给该第三方服务。README 还记录了 HTTP 代理模式,可在本地端口转发任意上游路径,其可达范围超出所列工具。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Uk Parliament Erskinemay,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

[MCP Compatible] [AI Agent Ready]

UK Parliament Erskine May MCP Server

Summary

This MCP server provides structured access to UK Parliament Erskine May content using the Model Context Protocol. It enables AI agents to query chapters, parts, sections, and index terms through API-backed tools for reliable data access. Developers can connect the MCP server via stdio transport to retrieve authoritative procedural guidance and references. The server exposes tools that map directly to the Erskine May API for search and lookup workflows.

Features

  • Retrieve chapters, parts, sections, and section overviews by identifier.
  • Browse and search index terms and paragraphs by keyword.
  • Support structured lookups with consistent response envelopes.
  • Preserve upstream JSON payloads for downstream tools and AI agents.

Available Tools

get_chapter_by_chapter_number

Returns a single chapter overview by chapter number.

Parameters:

  • chapterNumber (number, path) – Chapter number.

browse_index_terms

Returns a list of index terms by start letter.

Parameters:

  • startLetter (string, query)
  • skip (number, query)
  • take (number, query)

get_index_term_by_index_term_id

Returns an index term by id.

Parameters:

  • indexTermId (number, path) – Index term id.

list_parts

Returns a list of all parts.

get_part_by_part_number

Returns a part by part number.

Parameters:

  • partNumber (number, path) – Part number.

search_index_term_results_by_search_term

Returns a list of index terms which contain the search term.

Parameters:

  • searchTerm (string, path)
  • skip (number, query)
  • take (number, query)

get_paragraph_by_reference

Returns a section overview by reference.

Parameters:

  • reference (string, path)

search_paragraph_results_by_search_term

Returns a list of paragraphs which contain the search term.

Parameters:

  • searchTerm (string, path)
  • skip (number, query)
  • take (number, query)

search_section_results_by_search_term

Returns a list of sections which contain the search term.

Parameters:

  • searchTerm (string, path)
  • skip (number, query)
  • take (number, query)

get_section_by_section_id

Returns a section by section id.

Parameters:

  • sectionId (number, path)

get_section_overview_by_section_id_and_step

Returns a section overview by section id and step.

Parameters:

  • sectionId (number, path)
  • step (number, path)

Example Output

json
{  "status": 200,  "data": {    "sectionId": 12,    "title": "Order in debate",    "content": "..."  },  "upstream_path": "/api/Section/12",  "retrieved_at": "2026-03-11T10:00:00.000Z"}

Quick Start

Run the MCP server using npx:

bash
npx -y -p @darkhorseone/mcp-server-uk-parliament-erskinemay mcp-server-uk-parliament-erskinemay

MCP Configuration

Example mcpServers configuration for stdio transport:

json
{  "mcpServers": {    "uk-parliament-erskinemay": {      "command": "npx",      "args": ["-y", "-p", "@darkhorseone/mcp-server-uk-parliament-erskinemay", "mcp-server-uk-parliament-erskinemay"],      "env": {        "UPSTREAM_BASE_URL": "https://erskinemay-api.parliament.uk",        "REQUEST_TIMEOUT_MS": "10000"      }    }  }}

Example Usage

  • Fetch a chapter by chapter number.
  • Search sections for a keyword and paginate results.
  • Retrieve a section overview by id and step.
  • Browse index terms starting with a letter.

Use Cases

  • AI agents answering procedural questions with authoritative references.
  • Legal or parliamentary research tools mapping sections and paragraphs.
  • Civic tech workflows enriching datasets with Erskine May references.
  • Automation systems that index procedural content for retrieval.

Data Source

UK Parliament Erskine May API https://erskinemay-api.parliament.uk

Installation

Run directly using npx:

bash
npx -y -p @darkhorseone/mcp-server-uk-parliament-erskinemay mcp-server-uk-parliament-erskinemay

Or install via pnpm from the repository root:

bash
pnpm install

Run (HTTP proxy server)

Build first, then start:

bash
pnpm --filter @darkhorseone/mcp-server-uk-parliament-erskinemay run buildpnpm --filter @darkhorseone/mcp-server-uk-parliament-erskinemay run start:http

Set a custom HTTP port with the UKP_HTTP_PORT environment variable (default: 3000):

bash
UKP_HTTP_PORT=3000 pnpm --filter @darkhorseone/mcp-server-uk-parliament-erskinemay run start:http

Published package command:

bash
npx -y -p @darkhorseone/mcp-server-uk-parliament-erskinemay -- mcp-server-uk-parliament-erskinemay-http

If your shell cannot resolve the bin ("command not found"), run the HTTP entrypoint directly:

bash
npx -y -p @darkhorseone/mcp-server-uk-parliament-erskinemay -- node ./dist/http.js

Health check:

bash
curl http://127.0.0.1:3000/healthz

Proxy pattern:

text
GET /proxy/<upstream-path>?<query>

Example:

bash
curl "http://127.0.0.1:3000/proxy/api/Part"

License

MIT License

MCP Metadata

Protocol: Model Context Protocol Transport: stdio Tools: get_chapter_by_chapter_number, browse_index_terms, get_index_term_by_index_term_id, list_parts, get_part_by_part_number, search_index_term_results_by_search_term, get_paragraph_by_reference, search_paragraph_results_by_search_term, search_section_results_by_search_term, get_section_by_section_id, get_section_overview_by_section_id_and_step

来源:servers/uk-parliament-erskinemay/README.md,提交 38e74c9

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v1.0.1最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。