Lobbyist Registry MCP

游说者注册表MCP服务器

一 主控程序 为Claude提供搜索访问权限的服务器 加拿大政府游说者登记处。它下载官方批量数据，将其索引到本地SQLite数据库中，并公开结构化搜索工具。

为什么

Lobbyist注册表没有公共API。唯一的选择是 网络搜索表单 和 批量CSV下载该服务器弥合了这一差距，因此克劳德可以按需搜索注册、通信、主题和政府机构。

数据

所有数据均来自游说专员办公室的开放数据门户：

数据每周更新一次。服务器在首次使用时下载并索引它（下载约97 MB，需要几分钟）。之后，搜索是即时的。使用 refresh_data 工具重新下载。

先决条件

• Python 3.10+
• 紫外线 （Python包管理器）

安装

1.克隆存储库

git clone https://github.com/CMartinChan/lobbyist-registry-mcp.git
cd lobbyist-registry-mcp

2.安装依赖项

uv sync

3.添加到克劳德代码

claude mcp add lobbyist-registry -- uv --directory /path/to/lobbyist-registry-mcp run server.py

或者手动添加到MCP配置文件中(~/.claude.json 对于用户级别，或 .mcp.json 项目级）：

{
  "mcpServers": {
    "lobbyist-registry": {
      "command": "uv",
      "args": ["--directory", "/path/to/lobbyist-registry-mcp", "run", "server.py"]
    }
  }
}

4.安装技能（可选，推荐）

技能告诉克劳德何时以及如何使用注册表工具。当你的提示提到游说、政府关系、宣传或相关话题时，它会自动触发。您还可以使用以下命令显式调用它 /lobbyist-registry.

选项A-Claude自定义（推荐，跨设备同步）

1. 打开克劳德代码设置→ 定制→ 技能
2. 上传预打包的 lobbyist-registry.skill 来自存储库根目录的文件

选项B——本地安装（仅此机器）

# Windows
cp -r skill/ "$USERPROFILE/.claude/skills/lobbyist-registry/"

# macOS / Linux
cp -r skill/ ~/.claude/skills/lobbyist-registry/

5.添加CLAUDE.md条目（可选，推荐）

将以下内容添加到您的全局 ~/.claude/CLAUDE.md （或项目级别 CLAUDE.md)因此，即使技能没有明确触发，Claude也会考虑注册表工具：

## Lobbyist Registry

The lobbyist-registry MCP server provides search tools for the Government of Canada Lobbyist Registry (lobbycanada.gc.ca). Consider using it when work involves lobbying, government relations, policy research, advocacy tracking, stakeholder mapping, or business development in federally regulated sectors (housing, energy, health, defence, infrastructure, environment, etc.). The /lobbyist-registry skill provides detailed guidance on effective search patterns.

6.重新启动克劳德代码

服务器将出现在您可用的MCP工具中。第一次使用任何搜索工具时，它都会自动下载并索引数据。

工具

search_registrations

按组织、说客、类型或自由文本搜索游说注册。

search_communications

搜索每月的沟通报告——谁游说谁，何时，关于什么。

lookup_registration

获取特定注册号的完整详细信息，包括所有主题、政府机构、游说者、沟通技巧、受益人和资金。

search_by_subject

查找有关政策主题的所有游说活动。返回注册和最近的通信。

search_by_institution

查找所有针对特定政府机构的游说活动。

summarize_lobbying

汇总统计：计数、顶级组织、顶级学科、顶级机构。

refresh_data

从批量CSV源重新下载并重新索引数据。

主题类别

登记处使用54个主题代码：

土著事务、农业、动物福利、艺术和文化、双语/官方语言、广播、预算、儿童服务、气候、宪法问题、消费者问题、国防、经济发展、教育、选举、就业和培训、能源、环境、联邦-省关系、金融机构、渔业、外交、林业、政府采购、卫生、住房、移民、工业、基础设施、知识产权、国内贸易、国际发展、国际关系、国际贸易、司法和执法、劳工、媒体、采矿、市政、国家安全/安保、自然资源、养老金、隐私和信息获取、区域发展、宗教、研究与发展、科学技术、小企业、体育、税收和金融、电信、旅游，交通运输

运作原理

1. 首次使用时，服务器从游说专员办公室下载两个ZIP文件（总计约97 MB） 开放数据门户
2. CSV被提取并加载到具有FTS5全文搜索索引的本地SQLite数据库中
3. 数据库存储在平台的标准数据目录中：

- 视窗: %LOCALAPPDATA%\lobbyist-registry-mcp\ - macOS: ~/Library/Application Support/lobbyist-registry-mcp/ - Linux: ~/.local/share/lobbyist-registry-mcp/

1. 后续搜索查询本地数据库（即时）
2. 每份回复都包含一个数据新鲜度指标，并在适用的情况下，直接链接到官方注册页面

远程同步（可选）

对于多设备设置，服务器可以从远程服务器拉取预构建的数据库，而不是在本地下载CSV并为其编制索引。如果您有一个按计划刷新数据的中央服务器，这将非常有用。

同步完全是可选择的。 如果在默认路径上找不到SSH密钥，则禁用同步，服务器将完全按照上述方式工作——在首次使用时下载自己的数据。

运作原理

启动时，服务器检查是否可以通过SSH访问远程主机。如果远程数据库比本地副本新，它将通过SCP拉取它。如果远程无法访问或本地副本已经是最新的，服务器将正常运行。

配置

设置这些环境变量以启用同步：

远程服务器刷新

在远程服务器上，使用以下命令运行计划刷新：

uv run server.py --refresh

这将下载最新的CSV数据，重建数据库，然后退出。您可以使用cron或systemd计时器来安排此操作。

注册类型

许可证

数据根据 开放数据许可证——游说专员办公室.