india-regulatory-mcp

india-reg-mcp

一个 MCP 服务，为 Claude（以及任何 MCP 客户端）提供可搜索且附有引文的 RBI 和 SEBI 监管文件访问，包括通函、主指令、通知和法规。

无需 API 密钥。无需订阅。完全基于免费的政府公开数据构建。

---

为什么要构建它

印度的监管规则散落在 rbi.org.in 和 sebi.gov.in 上数以千计的 PDF 和 HTML 页面中。这些规则彼此频繁引用和取代。目前没有可供 AI 使用的方式来询问“X 事项的现行规则是什么”，并获得有来源依据的答案。

这个 MCP 服务解决了这一问题。它会抓取、索引 RBI 和 SEBI 文件的全文，并将其存入本地 SQLite 数据库，让 Claude 能够即时搜索和检索带有官方引文的一手监管文本。

**这不是法律建议工具。**它检索一手文件，让你能依据实际规则进行推理，而不是依赖幻觉式摘要。

---

功能

• 全文搜索所有已索引的 RBI 和 SEBI 文件
• 按 ID 检索完整文件正文，并附官方来源链接
• 列出近期文件——适用于询问“本月有什么变化”
• 列出主指令和主通函——各个主题下汇总后的现行规则
• 按部门浏览——如 SEBI 的投资管理、市场监管等部门
• 按需同步——从监管机构网站拉取新发布的文件
• 按主题搜索——一次调用即可同时返回汇总后的主规则和近期相关通函

---

工具（共 8 个）

工具	描述
search_regulations	全文搜索，可选监管机构／类型筛选条件
get_document	按 ID 检索文件全文
get_recent	获取最新文件，可选筛选条件
list_master_directions	列出所有 RBI 主指令和 SEBI 主通函
list_by_department	按部门名称列出 SEBI 文件
sync_latest	增量抓取 RBI 和 SEBI 发布的新文件
sync_status	显示文件数量明细和上次同步时间
search_by_topic	合并返回某主题的主规则和近期通函

---

架构

RBI / SEBI websites
        │
        ▼
   Scrapers (TypeScript)
   rbi.ts  ──── ASP.NET POST with viewstate tokens
   sebi.ts ──── AJAX pagination via JSP endpoint
        │
        ▼
   SQLite DB  (~/.india-reg-mcp/regdata.db)
   ├── documents table (full text, metadata, source URLs)
   ├── documents_fts (FTS5 full-text index, porter stemmer)
   └── sync_meta (last sync timestamp)
        │
        ▼
   MCP Server (stdio transport)
   ├── 8 tools exposed to Claude
   └── Every result includes official source URL + disclaimer

**关键设计决策：**工具不会实时抓取数据。抓取器会将数据存入本地 SQLite 数据库，工具只需即时查询。只有 sync_latest 会访问监管机构网站。这让每次工具调用都很快，在正常使用期间不会访问政府服务器，并且索引完成后可离线使用。

---

安装

前提条件

• Node.js 18+
• Claude Code CLI 或 Claude Desktop

---

选项 A — npm（推荐）

全局安装并一步完成与 Claude Code 的注册：

npm install -g india-reg-mcp
claude mcp add -s user india-reg india-reg-mcp

也可以使用 npx，无需安装：

claude mcp add -s user india-reg npx india-reg-mcp

首次同步

添加服务后，让 Claude 执行同步：

Run sync_latest to populate the index

也可以直接运行：

npx india-reg-mcp  # starts the MCP server

---

选项 B — 从源代码安装

git clone https://github.com/Akhilgovind02/india-regulatory-mcp.git
cd india-regulatory-mcp
npm install
npm run build

首次同步（填充数据库）

npm run sync

此操作会抓取过去 36 个月的 RBI 通知，以及近期约 1000 份 SEBI 通函。根据网络连接情况，需要 5–15 分钟。数据库存储在 ~/.india-reg-mcp/regdata.db，重新构建后仍会保留。

进度会打印到 stderr：

[sync] RBI 2026-6: 12 docs found
[sync] RBI 2026-5: 18 docs found
...
[sync] SEBI ssid=6 page 0: 25 docs
...
[sync] Sync complete.

---

配置

Claude Code（CLI）

通过 npm（全局安装）：

claude mcp add -s user india-reg india-reg-mcp

通过 npx（无需安装）：

claude mcp add -s user india-reg npx india-reg-mcp

通过源代码构建：

claude mcp add -s user india-reg node /ABSOLUTE/PATH/TO/india-regulatory-mcp/dist/index.js

也可以手动添加到 ~/.claude.json：

{
  "mcpServers": {
    "india-reg": {
      "command": "npx",
      "args": ["india-reg-mcp"]
    }
  }
}

Claude Desktop

编辑 %APPDATA%\Claude\claude_desktop_config.json（Windows）或 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：

{
  "mcpServers": {
    "india-reg": {
      "command": "npx",
      "args": ["india-reg-mcp"]
    }
  }
}

编辑配置后，请彻底重启 Claude Desktop。

---

使用示例

连接后，可以自然地向 Claude 提问：

What are the current RBI rules on digital lending?

→ Claude 调用 search_by_topic("digital lending")——返回《数字贷款主指南》以及近期的修订通告，每份文件都附有官方来源链接。

What new SEBI circulars came out this month?

→ Claude 调用 get_recent(regulator="SEBI", limit=10)。

Show me all RBI Master Directions

→ Claude 调用 list_master_directions(regulator="RBI")。

What are the KYC requirements for mutual funds?

→ Claude 调用 search_regulations("KYC mutual fund", doc_type="master_direction")。

Pull in the latest regulatory updates

→ Claude 调用 sync_latest()——增量同步，仅获取新文件。

---

数据来源

RBI（印度储备银行）

• 通知 + 通告：rbi.org.in/Scripts/NotificationUser.aspx
• 主指南：rbi.org.in/Scripts/BS_ViewMasterDirections.aspx
• 主通告：rbi.org.in/Scripts/BS_ViewMasterCirculardetails.aspx
• 文件正文：HTML 页面文本（仅 PDF 文件则使用 PDF 备用方案）

SEBI（印度证券交易委员会）

• 通告（ssid=7）：截至 2026 年 6 月约有 2,775 份文件
• 主通告（ssid=6）：按主题汇总的现行规则
• 法规（ssid=3）：法定法规
• 文件正文：主要从 PDF 嵌入内容中提取，使用 pdf-parse

---

文件类型

类型	来源	描述
circular	RBI + SEBI	特定时间点的监管指引
master_direction	RBI	某个主题的现行规则汇总（取代较早的通告）
master_circular	SEBI	与主指南相同，是 SEBI 使用的术语
notification	RBI	各项法案下的法定通知
regulation	SEBI	正式法规（例如 SEBI (FPI) Regulations 2019）

对于合规问题，请从 master_direction/master_circular 开始。 这些文件代表规则的当前状态，而非某个特定时间点的快照。

---

保持索引更新

数据库是某个时间点的快照。RBI 和 SEBI 经常发布新文件（每周数份）。

选项 1 — 询问 Claude：“拉取最新监管更新”→ Claude 调用 sync_latest。

选项 2 — CLI：

npm run sync

选项 3 — 定时任务（cron 示例，每周日凌晨 2 点运行）：

0 2 * * 0 cd /path/to/india-regulatory-mcp && npm run sync >> ~/.india-reg-mcp/sync.log 2>&1

sync_latest 和 npm run sync 均为增量操作——会跳过数据库中已有的文件。

---

项目结构

india-regulatory-mcp/
├── src/
│   ├── index.ts                  ← MCP server, all 8 tools
│   ├── db/
│   │   ├── schema.ts             ← SQLite schema + FTS5 setup
│   │   └── queries.ts            ← DB read/write functions
│   ├── scrapers/
│   │   ├── rbi.ts                ← RBI scraper (ASP.NET POST + viewstate)
│   │   ├── sebi.ts               ← SEBI scraper (AJAX pagination)
│   │   ├── pdf.ts                ← PDF download + text extraction
│   │   ├── run-sync.ts           ← CLI full sync runner
│   │   └── repair-bodies.ts      ← Utility: backfill missing body text
│   └── util/
│       ├── http.ts               ← Polite fetch (UA + retry + delay)
│       └── format.ts             ← MCP response helpers
├── dist/                         ← Compiled output (not in repo)
├── package.json
└── tsconfig.json

---

技术说明

抓取方式

RBI 使用带有 viewstate 令牌的 ASP.NET。抓取器启动时会获取 viewstate，然后按月发送 POST 请求以获取文件列表。内容从 HTML 通告页面中提取；仅有 PDF 的文件则使用 PDF 备用方案。

SEBI 使用基于 JSP 的列表，并通过 AJAX 分页。第 1 页使用 GET 请求（建立 JSESSIONID）。第 2 页及之后的页面会携带会话 Cookie 向 getnewslistinfo.jsp 发送 POST 请求。通告内容通常是嵌入 iframe 的 PDF——抓取器会提取 PDF URL，并使用 pdf-parse 解析。

礼貌抓取

• 每个主机的并行请求数上限为 2
• 获取文件之间延迟 300 毫秒
• 获取列表页之间延迟 500 毫秒
• 对 429/5xx 响应进行指数退避
• 使用用于标识该工具的真实 User-Agent 字符串

数据库

• 位置：~/.india-reg-mcp/regdata.db
• 使用 WAL 模式以提升性能
• 使用 Porter 词干提取器的 FTS5——可处理词形变化（“lending”可匹配“lend”和“lender”）
• 全文搜索词逐词加引号，以安全处理连字符和特殊字符

---

技术栈

包	版本	用途
@modelcontextprotocol/sdk	1.29.0	MCP 服务框架
better-sqlite3	12.10.0	内置 FTS5 的 SQLite
cheerio	1.2.0	HTML 解析
pdf-parse	2.4.5	PDF 文本提取
turndown	7.2.4	HTML → Markdown
p-limit	7.3.0	并发控制
zod	4.4.3	架构验证

---

免责声明

此工具从 RBI 和 SEBI 的官方出版物中检索并呈现一手监管文件。它不提供法律建议。请始终通过链接的官方文件进行核实。该索引是某一时点的快照——请使用 sync_latest 获取近期出版物。