Nara MCP Server（搜索国家集市招标公告）

MCP服务器，用于搜索来自G2B的韩国政府采购招标通知（"。

特性

🔍 集成搜索：以劳务招标公告+事前规格为关键词进行搜索（搜索时间自由设置，默认为7天）
💰 预算信息：在所有搜索结果中显示预算金额
📅 显示结束状态：显示所有公告 ✅ 진행중 / 🔴 마감 明确区分状态
📎 提取文件：自动下载提案申请（RFP）并提取文本
🗂️ 智能过滤：仅自动筛选提案申请/任务指示文件
🏢 个性化推荐：基于部门配置文件的灵活推荐（Top N或完整列表）
📄 多格式支持：自动处理HWP、HWPX、PDF、DOCX、XLSX、ZIP文件
🎯 战略分析：基于附件的投标策略建议

快速开始

通过3个步骤开始：

从PyPI安装

   pip install nara-mcp-server

获取API密钥 （需要2个）

- 公共数据门户在 “采购厅_国家集市招标信息服务” 申请使用→ NARA_API_KEY - 在同一门户网站上 “采购厅_国家集市规格信息服务（HrcspSsstndrdInfoService）” 申请使用→ NARA_PRESPEC_API_KEY

配置Claude桌面

增添 claude_desktop_config.json:

   {
     "mcpServers": {
       "nara-jangteo": {
         "command": "uvx",
       "args": [
           "--python",
           "3.11",
           "--from",
           "nara-mcp-server",
           "nara-server"
         ],
         "env": {
           "NARA_API_KEY": "입찰공고 API KEY",
           "NARA_PRESPEC_API_KEY": "사전규격 API KEY",
           "UV_LINK_MODE": "copy"
         }
       }
     }
   }

开始使用！

Restart Claude Desktop and ask：“请在国家集市上搜索‘AI’关键字的招标公告。”

先决条件

1.发放API密钥（必需-2种）

国家集市API 一般招标公告哇 词典规格这是单独的服务，需要分别申请使用。

①招标API密钥（NARA_API_KEY)

公共数据门户连接和会员注册
“采购厅_国家集市招标信息服务” 搜索后申请使用
我的页面>开发帐户 在中验证Service Key（使用常规验证密钥解码）

②预规范API密钥（NARA_PRESPEC_API_KEY)

在同一门户网站上 “采购厅_国家集市规格信息服务（HrcspSsstndrdInfoService）” 搜索后申请使用
批准后确认相同的Service Key

两项服务的密钥可能相同，但必须在各自的申请完成后才能正常运行。

2.Python环境

需要Python 3.10或更高版本

安装

选项1：来自PyPI（推荐）

最简单的安装方法：

pip install nara-mcp-server

备注：这将安装 nara-server 全局命令，便于访问。

选项2：来源（用于开发）

如果你想贡献或修改代码：

git clone https://github.com/Datajang/narajangteo_mcp_server.git
cd narajangteo_mcp_server
pip install -e .

配置

使用.env文件（建议用于开发）

创建一个 .env 项目根目录中的文件：

# .env
NARA_API_KEY=입찰공고_서비스키
NARA_PRESPEC_API_KEY=사전규격_서비스키

这 .env 运行服务器时会自动加载文件。

Claude桌面配置

设置文件位置：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "nara-jangteo": {
      "command": "uvx",
      "args": [
        "--python",
        "3.11",
        "--from",
        "nara-mcp-server",
        "nara-server"
      ],
      "env": {
        "NARA_API_KEY": "입찰공고 API KEY",
        "NARA_PRESPEC_API_KEY": "사전규격 API KEY",
        "UV_LINK_MODE": "copy"
      }
    }
  }
}

重要事项：

安装PyPI时 nara-server 命令将自动注册
NARA_API_KEY -输入招标公告ServiceKey
NARA_PRESPEC_API_KEY -输入预配ServiceKey（未设置时禁用预配搜索）
Claude Desktop需要重新启动

其他MCP客户端

Continue、Cline等其他MCP客户端也可以以同样的方式进行设置。

开发与测试

使用.env文件（推荐）

为了地方发展，创建一个 .env 文件：

# .env
NARA_API_KEY=입찰공고_서비스키
NARA_PRESPEC_API_KEY=사전규격_서비스키

这 .env 文件会自动加载 未被git跟踪 （.微笑）。

工作流程示例：

# 1. .env 파일 생성 후 두 API 키 입력
# NARA_API_KEY=your_bid_key
# NARA_PRESPEC_API_KEY=your_prespec_key

# 2. Run MCP Inspector (no env setup needed!)
npx @modelcontextprotocol/inspector uv --directory . run python -m nara_server.server

可用工具

1. `get_bids_by_keyword`

关键字搜索劳务招标公告和事前规格。（最多20个结果）

参数：

keyword （必需）：搜索关键字（例如“人工智能”、“AI”、“平台”、“系统构建”）
days （可选，默认值：7）：搜索持续时间（天）。搜索旧公告时增加（例如，30、60、90）

返回信息：

一般招标公告：

公告名（bidNtceNm）
公告编号（bidNtceNo）
需求机构（dminsttNm）
预算（bdgtAmt/presmptPrce）
截止日期（bidClseDt）+正在进行/显示截止状态
提案请求文件（仅自动过滤包含提案请求/建议关键字的文件）

预规格：

品名/服务名称（prdctClsfcNoNm）
预规格编号（bfSpecRgstNo）
订购机构（orderInsttNm）
分配预算（asignBdgtAmt）
意见截止日期（opninRgstClseDt）
规格文档文件URL（specDocFileUrl1~5）

示例问题：

나라장터에서 "인공지능" 키워드로 입찰공고를 검색해줘

AI 관련 정부 프로젝트 입찰 공고를 최근 30일 기준으로 찾아줘

______________________________________________________________________

2. `recommend_bids_for_dept`

根据部门/团队配置文件推荐定制招标公告。

参数：

keyword （必需）：搜索关键字
department_profile （必需）：部门/团队说明（例如“UI/UX设计团队”、“AI/ML开发团队”）
days （可选，默认值：7）：搜索持续时间（天）。搜索旧公告时增加（例如，30、60、90）

搜索范围：

最多60个结果（一般招标30个+事前规格30个）

输出方式：

如果用户要求“Top 5”或特定数量，则推荐该数量。
如果您请求“所有相关公告”，将按适合度顺序显示完整列表
优先推荐有预算的项目
仅自动过滤并显示提案申请/任务指示文件

示例问题：

우리 팀은 클라우드 인프라 구축 전문팀이야. "클라우드" 키워드로 우리 팀에 맞는 입찰공고 Top 5를 추천해줘

데이터베이스 마이그레이션 전문가인데, "DB" 키워드로 관련된 모든 공고를 보여줘

______________________________________________________________________

3. `analyze_bid_detail`

下载招标附件（提案申请），提取并分析文本。

参数：

file_url （必需）：附件URL（搜索结果的提案请求URL）
filename （必需）：文件名（搜索结果的文件名）
department_profile （可选）：部门说明（输入时包括战略分析）

支持类型：

汉王：韩文文档（主要格式，使用langchain-teddynote HWPLoader）
HWPX：韩文Office XML文档
PDF：基于文本的PDF（不包括基于图像的PDF）
docx 文件：MS Word文档
XLSX文件：Excel电子表格
压缩文件：自动选择内部文件

- 优先顺序：提案申请>任务指示>.hwp/.hwpx>.docx/.pdf

示例问题：

위 공고의 첨부파일을 분석해줘. 우리 팀은 AI 개발팀이야.

分析结果：

适合度得分（0-100）：团队与项目的契合度
核心任务：团队要执行的核心任务
制胜策略：3种投标策略
风险因素：风险因素（技术堆栈、时间表、处罚等）

使用示例

默认搜索

Q: 나라장터에서 "시스템 개발" 키워드로 입찰공고를 검색해줘

A: 🔍 **일반 입찰 공고 (Regular Bids)**
   Found 15 bid notice(s) total, 15 retrieved
   📅 Search period: 20260116 ~ 20260123

   ## 1. AI 기반 고객관리 시스템 개발 용역
      📌 공고번호: 20260112345-00
      🏢 수요기관: 서울시청
      💰 예산: 150,000,000원
      ⏰ 마감일시: 202601201430 (✅ 진행중)
      📎 제안요청서:
         - 제안요청서_AI시스템.hwp: [URL]

   ================================================================================
   📋 **사전규격 공고 (Preliminary Specifications)**
   Found 3 pre-spec(s) total, 3 retrieved

   ## 1. 📋 [사전규격] 고객관리 플랫폼 구축
      📌 사전규격번호: PRE20260101-01
      🏢 발주기관: 경기도청
      💰 배정예산: 80,000,000원
      ⏰ 의견마감일시: 202601251700 (🔴 마감)
      📎 규격문서:
         - 규격문서 1: [URL]

个性化推荐

Q: 우리 팀은 React 기반 웹 프론트엔드 개발 전문팀이야. "플랫폼 구축" 키워드로 우리 팀에 맞는 입찰공고 Top 5를 추천해줘

A: 🎯 Department-Filtered Integrated Search Results

   📋 Department Profile: React 기반 웹 프론트엔드 개발 전문팀
   🔍 Keyword: 플랫폼 구축
   📊 Results:
     - Regular Bids: 22 open (out of 30 total)
     - Pre-Specs: 8 open (out of 30 total)

   **Top 5 Recommendations:**

   1. ✅ [BID] 시민참여 플랫폼 구축 (적합도 95점)
      - 예산: 200,000,000원
      - 이유: React/TypeScript 기반 웹 프론트엔드 구축 명시, UI/UX 디자인 역량 중요

   2. ✅ [PRESPEC] 공공서비스 웹포털 사전규격 (적합도 90점)
      - 예산: 150,000,000원
      - 이유: 반응형 웹 디자인 요구, 사전 의견 제출로 경쟁력 확보 가능
   ...

战略分析

Q: 위 1번 공고의 첨부파일을 분석해줘

A: 📄 Bid Document Analysis

   📎 File: 제안요청서_시민참여플랫폼.hwp

   ## Strategic Analysis

   **Fit Score:** 92/100
   - React 18, TypeScript, Tailwind CSS 기술스택 요구
   - 반응형 웹 디자인 및 접근성(WCAG 2.1) 준수 필요

   **Core Tasks:**
   1. React 기반 SPA(Single Page Application) 개발
   2. 사용자 대시보드 및 관리자 콘솔 UI 구현
   3. REST API 연동 및 상태 관리 (Redux/Zustand)

   **Winning Strategy:**
   1. 포트폴리오에서 정부기관 반응형 웹 사례 강조
   2. 접근성 준수 경험 및 웹 표준 인증서 제시
   3. React 성능 최적화 기법 (Code Splitting, Lazy Loading) 강조

   **Risk Factors:**
   - ⚠️ 개발 기간 3개월로 촉박함 (일반적으로 4-5개월 소요)
   - ⚠️ 지체상금: 일 0.1% (최대 10%)
   - ✅ 기술스택은 팀 역량과 100% 일치

故障排除

1.ValueError:找不到NARA_API_KEY/NAR_PRESPEC_API_KEY

原因：API密钥未设置为环境变量。

解决方法：

Claude Desktop配置文件中的 env 在节中 NARA_API_KEY哇 NARA_PRESPEC_API_KEY 添加
预配键（NARA_PRESPEC_API_KEY）未设置时，禁用规格前搜索，但常规招标搜索仍有效
重新启动Claude Desktop

2.未找到结果

原因：在此期间没有该关键字的公告。

解决方法：

尝试搜索其他关键字（使用更常见的关键字）
days 增加参数以延长搜索时间（例如days=30，days=60）
截止的公告 🔴 마감 显示时保持原样，无需另行检查

3.API错误（代码：20-拒绝访问）

原因：API密钥无效或未批准使用申请。

解决方法：

公共数据门户 >在我的页面上验证ServiceKey
确认是否批准使用申请

4.提取HWP文件失败

原因:

DRM/加密的HWP文件
非标准编码或损坏的文件
使用特殊的压缩方式

解决方法：

尝试从源链接手动下载
验证是否存在PDF版本文件
使用其他附件（DOCX、PDF等）

注意：

这台服务器 langchain-teddynote 可以使用HWPLoader处理大多数HWP文件
提取失败时 olefile 自动回退到解析器

API信息

数据来源：采购厅国家集市（Korea Public Procurement Service）
端点:

- 一般投标： http://apis.data.go.kr/1230000/ad/BidPublicInfoService/getBidPblancListInfoServcPPSSrch - 预规格： http://apis.data.go.kr/1230000/ao/HrcspSsstndrdInfoService/getPublicPrcureThngInfoServcPPSSrch

API密钥：两项服务都需要申请公共数据门户（NARA_API_KEY, NARA_PRESPEC_API_KEY)
公告类型：劳务（Service）-咨询、开发、SI项目
搜索时间：默认7天， days 可自由设置参数（例如，30、60、90天）
分割日期区块：自动绕过API日期范围限制（~15天），内部分割15天单位后合并结果
过滤:

- 显示所有公告，截止日期旁边 ✅ 진행중 / 🔴 마감 显示状态 - 预规格项目包括： 📋 [사전규격] 用标签明确区分普通招标公告

注意：

物品公告：需要更改端点（getBidPblancListInfoThngPPSSrch)
施工公告：需要更改端点（getBidPblancListInfoCnstwkPPSSrch)

技术栈

python: 3.10+
MCP框架:

- mcp>=1.15.0 -模型上下文协议SDK

HTTP客户端: httpx>=0.27.0 -异步HTTP请求
文件提取:

- langchain-teddynote>=0.3.9 -增强的HWP提取（主要，支持zlib压缩） - olefile>=0.47 -HWP回退（旧版MS OLE格式解析器） - pypdf>=4.0 -PDF文本提取 - python-docx>=1.1 -DOCX解析 - openpyxl>=3.1 -XLSX读数

LLM集成:

- langchain>=0.1.0,=0.1.0,=1.0.0 -环境变量管理

项目结构

narajangteo_mcp_server/
├── src/
│   └── nara_server/
│       ├── __init__.py          # Package initialization
│       ├── server.py             # Main MCP server (STDIO transport)
│       └── file_extractor.py     # Multi-format file text extraction
├── pyproject.toml                # Python project metadata & dependencies
├── .env                          # Environment variables (local)
├── README.md                     # This file
├── CLAUDE.md                     # Developer guide
└── LICENSE                       # MIT License

发展

建立开发环境

# Clone repository
git clone https://github.com/Datajang/narajangteo_mcp_server.git
cd narajangteo_mcp_server

# Install in editable mode
pip install -e .

# Set environment variables
export NARA_API_KEY="your_bid_key"          # MacOS/Linux
export NARA_PRESPEC_API_KEY="your_prespec_key"

set NARA_API_KEY=your_bid_key               # Windows
set NARA_PRESPEC_API_KEY=your_prespec_key

# Or use .env file (recommended)
echo "NARA_API_KEY=your_bid_key" > .env
echo "NARA_PRESPEC_API_KEY=your_prespec_key" >> .env

运行服务器

# Run directly
nara-server

# Or using Python module
python -m nara_server.server

MCP检验员测试

MCP Inspector为测试工具提供了一个交互式UI：

# Install Inspector
npm install -g @modelcontextprotocol/inspector

# Run with Inspector (automatically loads .env)
npx @modelcontextprotocol/inspector python -m nara_server.server

检查员将打开http://localhost:6274与：

交互式工具测试
实时请求/响应日志
工具参数验证

先决条件：

Node.js 18+(下载)

贡献

欢迎投稿！请遵循以下指南：

分叉存储库
创建要素分支
使用明确的提交消息进行更改
使用真实的API调用进行彻底测试
提交拉取请求

许可证

MIT许可证-请参阅许可证详细信息文件

作者

达坦 ()

链接

PyPI包: https://pypi.org/project/nara-mcp-server/
GitHub 仓库:https://github.com/Datajang/narajangteo_mcp_server
问题: https://github.com/Datajang/narajangteo_mcp_server/issues
公共数据门户: https://www.data.go.kr/
国家集市: https://www.g2b.go.kr/

致谢

采购厅国家集市for provided the public API
MCP协议的拟人化
韩国政府推动开放数据倡议

MCP Narajangteo

快速接入

详细介绍

Nara MCP Server（搜索国家集市招标公告）

特性

快速开始

先决条件

1.发放API密钥（必需-2种）

2.Python环境

安装

选项1：来自PyPI（推荐）

选项2：来源（用于开发）

配置

使用.env文件（建议用于开发）

Claude桌面配置

其他MCP客户端

开发与测试

使用.env文件（推荐）

可用工具

1. get_bids_by_keyword

2. recommend_bids_for_dept

3. analyze_bid_detail

使用示例

默认搜索

个性化推荐

战略分析

故障排除

1.ValueError:找不到NARA_API_KEY/NAR_PRESPEC_API_KEY

2.未找到结果

3.API错误（代码：20-拒绝访问）

4.提取HWP文件失败

API信息

技术栈

项目结构

发展

建立开发环境

运行服务器

MCP检验员测试

贡献

许可证

作者

链接

致谢

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP

1. `get_bids_by_keyword`

2. `recommend_bids_for_dept`

3. `analyze_bid_detail`