Assembly MCP

组装MCP

是韩国国会信息公开系统（Open API）的模型上下文协议（MCP）服务器。 Claude等AI代理可以实时查询和分析国会议案、会议记录、议员信息等。

此处提供英文README

______________________________________________________________________

主要功能

该服务器提供以下工具：

• 搜索和查询议案

- search_bills(keyword)：按关键字搜索议案。（例如“人工智能”、“预算”） - get_recent_bills()：获取最近提议的议案列表。 - get_bill_details(bill_id)：查询议案的详细信息（提案理由、主要要点等）。 - get_bill_info(...)：根据议案编号、发起人、日期等详细条件搜索议案。

• 会议记录和委员会

- get_meeting_records(bill_id)：查看与特定议案相关的委员会会议记录。 - search_meetings(...)：按日期、委员会名称等搜索会议记录。 - get_committee_list()：查询国会委员会列表。 - get_committee_members(...)：查询委员会成员（成员名单）。

• 国会议员信息

- get_member_info(name)：查询国会议员的个人资料、所属政党、选区等。 - get_representative_report(name): \[智能\] 生成综合报告，包括议员的基本信息、提案、委员会经历和投票经历。 - get_member_committee_careers(name)：查询议员的详细委员会活动经历。

• 表决和投票分析

- get_bill_voting_results(bill_id): \[智能\] 分析特定议案的全体会议表决结果（赞成/反对/弃权）和各政党的投票倾向。 - analyze_voting_trends(topic): \[智能\] 分析与特定主题（如“AI”、“税制”）相关的法案在全体会议上的投票倾向。 - get_member_voting_history(...)：查询特定议员或议案的个人表决记录。

• 智能分析和复合查询

- analyze_legislative_issue(topic): \[智能\] 通过对特定主题的法案、会议记录和主要议员进行综合分析，生成报告。 - get_bill_history(bill_id): \[智能\] 以时间轴的形式整合从议案的提出到处理的整个生命周期。 - get_legislative_reports(keyword): \[智能\] 实时联系并提供国会预算政策办公室（NABO）专业报告和国会新闻数据。 - get_committee_work_summary(committee_name): \[智能\] 将各委员会的搁置议案和相关报告合并起来，总结现状。

• 其他和高级功能

- get_assembly_info()：检查服务器状态和可用的API信息。 - list_api_services()：搜索所有可用的国会API服务。 - call_api_raw()：（高级用户）直接调用API服务。

LLM使用指南（重要）

• 该服务器是国会OpenAPI 约270个全部可用。不要因为不在高级工具中就回答“没有功能”。
• 优先使用智能工作流：与其简单地列出数据 analyze_ 或者 get_..._report 使用系列工具提供立体的见解。

- 主题分析: analyze_legislative_issue("AI") ->法案+会议+议员综合信息 - 议员分析: get_representative_report("의원명") ->个人资料+法案+经历+投票倾向 - 表决分析: get_bill_voting_results("의안ID") ->赞成和反对统计+各政党倾向

• 标准指南: list_api_services(keyword) → get_api_spec(service_id) → call_api_raw(service_id, params) 您可以通过组合查询任何信息。
• 请广泛搜索关键词（国文/英文，空格变形）。找到的ID为 get_api_spec确认所需参数后 call_api_raw调用。
• 示例：“委员会成员”→ list_api_services("위원 명단")在中确认服务ID→ get_api_spec通过确认参数→ call_api_raw通过查询名单→必要时 get_member_info通过补充个别议员的详细情况。
• 答：如果您不在高级工具中，请提出上述组合或直接调用以生成结果。
• 捷径：委员名单 get_committee_members可以通过直接查询，后续 get_member_info加上详细内容就可以了。

______________________________________________________________________

开始（Quick Start）

这个项目 uv 基于包管理器进行管理。 uvx无需安装即可运行。

1.发放API密钥

公共数据门户（data.go.kr）请在中申请使用“国会事务处”相关API，以获得认证密钥。

2.Claude Desktop集成设置

要在Claude Desktop应用程序中使用此MCP服务器，必须修改配置文件。

1. 打开配置文件：

- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json

1. 请添加以下内容。 (your_api_key_here 输入部分颁发的密钥）

{
  "mcpServers": {
    "assembly": {
      "command": "uvx",
      "args": ["git+https://github.com/StatPan/AssemblyMCP"],
      "env": {
        "ASSEMBLY_API_KEY": "your_api_key_here"
      }
    }
  }
}

1. 重启Claude Desktop🔌 可以使用带有图标的AssemblyMCP工具。

3.直接运行服务器（用于测试）

您可以在终端上测试服务器是否正常运行，而无需LLM联动。

# API 키 설정 (Linux/macOS)
export ASSEMBLY_API_KEY="your_api_key_here"

# 서버 실행
# GitHub에서 최신 코드를 받아와 실행합니다.
uvx git+https://github.com/StatPan/AssemblyMCP

______________________________________________________________________

开发指南

要为该项目做出贡献或在本地修改并运行该项目，请执行以下步骤：

基本要求

• Python 3.12或更高版本
• 紫外线 包管理器

安装和运行

# 1. 저장소 클론
git clone https://github.com/StatPan/AssemblyMCP.git
cd AssemblyMCP

# 2. 의존성 설치
uv sync

# 3. 환경 변수 설정 (.env 파일 생성)
cp .env.example .env
# .env 파일을 열어 ASSEMBLY_API_KEY를 입력하세요.

# 4. 개발 서버 실행
uv run assemblymcp

代码质量管理

# 린트 및 포맷팅
uv run ruff check .
uv run ruff format .

# 테스트 실행
uv run pytest

许可证

麻省理工学院

______________________________________________________________________

配置和托管（Configuration&hosting）

Assembly MCP “包括电池” 采用体系结构，无需单独修改代码，只需环境变量即可控制日志记录、缓存等操作功能。

环境变量设置（Environment Variables）

生产模式（Production Mode）

在Cloud Run、AWS Lambda等无服务器环境或生产部署中，建议设置以下设置：

# JSON 로깅 활성화 (로그 수집기 파싱 용이)
export ASSEMBLY_LOG_JSON=true

# 캐싱 활성화 (API 호출 비용 절감 및 속도 향상)
export ASSEMBLY_ENABLE_CACHING=true

部署（Deployment）

使用Docker，您可以轻松地将服务器部署到Google Cloud Run、Railway、Fly.io等云平台。

部署Docker

1. Dockerfile包括在内，无需另行设置即可构建。
2. 部署时 ASSEMBLY_API_KEY 等，请设置所需的环境变量。
3. 服务器基本上 Streamable HTTP 以模式运行。 8000 使用端口。

Google Cloud Run部署示例

gcloud run deploy assembly-mcp \
  --source . \
  --region asia-northeast3 \
  --allow-unauthenticated \
  --set-env-vars ASSEMBLY_API_KEY="your_key",ASSEMBLY_LOG_JSON="true",ASSEMBLY_ENABLE_CACHING="true"

主要更改

• 可流式HTTP传输：使用MCP协议的最新标准Streamable HTTP。
• 端点: /mcp MCP服务器在路径中运行。