Kokkai Lib MCP

国会图书馆MCP服务器

](https://badge.fury.io/js/kokkai-lib-mcp-server) 

国会图书馆会议录检索系统API用MCP服务器。Claude Desktop、Cursor、Cline、Dify等等，各种各样的MCP可以从客户端检索和获取国会会议录。

概要

这MCP服务器由国会图书馆提供国会会议录检索系统API中所述修改相应参数的值。提供以下功能：

• 会议録検索：按关键字、发言者、会议名、日期范围等搜索
• 発言详细取得：发言ID取得详细的发言内容

安装

方法1：npx直接运行（建议）

npx kokkai-lib-mcp-server

方法2:全局安装

npm install -g kokkai-lib-mcp-server
kokkai-lib-mcp-server

方法3:本地构建

# リポジトリのクローン
git clone https://github.com/groundcobra009/kokkai-lib-mcp.git
cd kokkai-lib-mcp

# 依存関係のインストール
npm install

# ビルド
npm run build

使用方法

Claude Desktop中的设置

Claude Desktop的配置文件（claude_desktop_config.json）中添加以下内容：

npx（建议）

{
  "mcpServers": {
    "kokkai-lib": {
      "command": "npx",
      "args": ["kokkai-lib-mcp-server"]
    }
  }
}

使用本地构建

macOS/Linux：

{
  "mcpServers": {
    "kokkai-lib": {
      "command": "node",
      "args": ["/path/to/kokkai-lib-mcp/build/index.js"]
    }
  }
}

窗户：

{
  "mcpServers": {
    "kokkai-lib": {
      "command": "node",
      "args": ["C:\\path\\to\\kokkai-lib-mcp\\build\\index.js"]
    }
  }
}

Cursor中的设置

Cursor的设置（.cursor/mcp.json或设置UI）中添加以下内容：

{
  "mcpServers": {
    "kokkai-lib": {
      "command": "npx",
      "args": ["kokkai-lib-mcp-server"],
      "autoStart": true
    }
  }
}

Cline中的设置

Cline对话框，您可以在此定义自定义格式MCP添加以下服务器：

{
  "kokkai-lib": {
    "command": "npx",
    "args": ["kokkai-lib-mcp-server"]
  }
}

Dify中的设置

Dify的MCP使用服务器：

1. 工具设置画面的双曲正切值
2. 自定义工具添加
3. 输入以下设置：

{
  "name": "kokkai-lib",
  "type": "mcp",
  "config": {
    "command": "npx",
    "args": ["kokkai-lib-mcp-server"],
    "transport": "stdio"
  }
}

或者，Dify直接在工作流中MCP添加节点并指定以下命令：

npx kokkai-lib-mcp-server

Manus中的设置

Manus的配置文件（.manus/config.json或设置UI）添加：

{
  "mcpServers": {
    "kokkai-lib": {
      "command": "npx",
      "args": ["kokkai-lib-mcp-server"],
      "enabled": true
    }
  }
}

或Manus的，之CLI使用：

manus mcp add kokkai-lib --command npx --args kokkai-lib-mcp-server

VS Code (Copilot)中的设置

VS Code的设置（settings.json）中添加以下内容：

{
  "mcp.servers": {
    "kokkai-lib": {
      "command": "npx",
      "args": ["kokkai-lib-mcp-server"]
    }
  }
}

其他MCP客户机

其他MCP客户端也可以使用以下命令格式：

• 命令: npx（或全局安装时kokkai-lib-mcp-server）
• 引数: ["kokkai-lib-mcp-server"]
• 传输标准： stdio

可用工具

1. search_minutes - 会议録検索

搜索国会会议录。可以组合多个条件进行搜索。

参数：

｜参数｜类型｜必需｜说明｜ |----------|-----|------|------| | keyword | string | 任意｜检索关键字（从发言内容中检索）｜ | speaker | string | 任意 | 発言者名（例：「岸田文雄」） | | meeting | string | 任意 | 会議名（例：「予算委員会」「本会議」） | | startDate | string | 任意|开始日（YYYY-MM-DD形式、例：「2024-01-01」）| | endDate | string | 任意|终了日（YYYY-MM-DD形式、例：「2024-12-31」）| | maximum | number | 任意｜获取的最大数量（默认值：10，最大值：100）｜

响应示例：

{
  "numberOfRecords": 150,
  "numberOfReturn": 10,
  "speeches": [
    {
      "speechId": "120314254X00120240201",
      "speaker": "岸田文雄",
      "date": "2024-02-01",
      "meeting": "衆議院本会議",
      "issue": "令和6年度予算について",
      "speechOrder": "1",
      "speech": "本日は、令和6年度予算について..."
    }
  ]
}

使用例:

• “请搜索过去一年国会对环境问题的讨论。”
• “请取得岸田总理关于经济政策的最新10件发言”
• “请调查2024年1月至3月预算委员会的讨论。”
• “请搜索国会关于少子化对策的讨论”

2. fetch_speech - 発言详细取得

会议录的发言ID中描述的场景，使用下列步骤创建明细表，以便在概念设计中分析体量的周长。

参数：

｜参数｜类型｜必需｜说明｜ |----------|-----|------|------| | speechId | string | 必须，必须ID（search_minutes获得ID） |

响应示例：

{
  "speechId": "120314254X00120240201",
  "speaker": "岸田文雄",
  "date": "2024-02-01",
  "meeting": "衆議院本会議",
  "issue": "令和6年度予算について",
  "speechOrder": "1",
  "speech": "本日は、令和6年度予算について...",
  "speechURL": "https://kokkai.ndl.go.jp/simple/detail?minId=120314254X00120240201",
  "meetingURL": "https://kokkai.ndl.go.jp/simple/txt/120314254X002"
}

使用例:

• “发言ID 120314254X00120240201 的明细栏样式中定义的设置。“
• “请显示刚才搜索的第一个发言的详细信息”

开発

在开发模式下启动

npm run dev

监视模式

npm run watch

构建

npm run build

项目配置

kokkai-lib-mcp/
├── src/
│   ├── index.ts       # MCPサーバーのメインファイル
│   └── ndl-api.ts     # 国会図書館API連携機能
├── build/             # ビルド出力（TypeScriptコンパイル後）
├── package.json       # npm設定
├── tsconfig.json      # TypeScript設定
├── LICENSE            # MITライセンス
├── .gitignore         # Git除外設定
├── .npmignore         # npm公開除外設定
└── README.md          # このファイル

実装详细

技术栈

• 言语：TypeScript 5.4+
• 运行时间：Node.js 18+
• 框架结构：模型上下文协议SDK v1.0+
• HTTP 客户机：轴
• 验证：zod

API端点

国会图书馆提供RESTful API使用：

• 検索API: https://kokkai.ndl.go.jp/api/1.0/minutes
• 発言详细API: https://kokkai.ndl.go.jp/api/1.0/speech/{speechId}

数据流

MCPクライアント
    ↓
MCPサーバー (このプロジェクト)
    ↓
国会図書館API
    ↓
レスポンス処理
    ↓
MCPクライアントへ返却

API仕様

这个服务器是国会图书馆的国会会议录检索系统API中所述修改相应参数的值。

详细信息API关于规格正式文档来修改标记元素的显示属性。

故障排除

常见问题

1. MCP服务器未启动

原因: Node.js旧版本\ 解决策: Node.js 18请安装以上内容

node --version  # 18.0.0以上であることを確認

2.发生构建错误

原因：未安装依赖关系\ 解决策：重新安装依赖关系

rm -rf node_modules package-lock.json
npm install
npm run build

3. API调用时出错

原因：国会图书馆API暂时不可用或汇率限制\ 解决策:

• 稍候再试
• 缩小搜索范围
• 减少获取次数

4. MCP客户端未识别

原因：配置文件路径错误\ 解决策:

• npx使用（不需要绝对路径）
• 对于本地构建，使用绝对路径

// ✅ 推奨
{
  "command": "npx",
  "args": ["kokkai-lib-mcp-server"]
}

// ❌ 相対パスは避ける
{
  "command": "node",
  "args": ["./build/index.js"]
}

貢献

欢迎拉式点播！您可以按照以下步骤做出贡献：

1. 分叉此存储库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推到分支（git push origin feature/amazing-feature）
5. 创建拉式请求

开发指南

• TypeScript正确使用的类型定义
• 代码格式遵循现有样式
• 为新功能添加适当的错误处理
• README需要更新时一并更新

路线图

• \[\]添加缓存功能
• \[\]更详细的搜索过滤器
• \[\]会期、议院的缩小功能
• \[\]导出功能（CSV、JSON）
• \[\]提高测试范围
• \[\]性能优化

相关链接

• 国会图书馆会议录检索系统
• 国会図書館 API仕様
• 模型上下文协议

许可证

麻省理工学院

谢辞

该项目由国会图书馆提供的国会会议录检索系统API中所述修改相应参数的值。