Skip to main content
Glama
KPIC MCP Server
by antegral

KPIC MCP Server

CI CodeQL

약학정보원(Korea Pharmaceutical Information Center) API를 위한 Model Context Protocol (MCP) 서버입니다.

기능

이 MCP 서버는 약학정보원의 의약품 정보를 조회할 수 있는 두 가지 도구를 제공합니다:

1. search_drugs_by_name

의약품 이름으로 대략적인 정보를 검색합니다.

파라미터:

  • drugname (string): 검색할 의약품의 이름 (영문 또는 한글)

반환값:

  • 검색된 의약품 목록 (JSON 배열)

  • 각 항목에는 약품명, 제조사, 효능, 용법용량 등의 기본 정보 포함

2. get_drug_detail_by_id

의약품 코드로 상세 정보를 조회합니다.

파라미터:

  • drugcode (string): 의약품 코드 (search_drugs_by_name의 결과에서 획득)

반환값:

  • 의약품의 상세 정보 (JSON 배열)

  • 포함 정보: 성분, 첨가제, 보관방법, 주의사항, 임부/수유부 정보 등

Related MCP server: MedData MCP Server

설치

pnpm install

빌드

pnpm build

실행

pnpm start

개발 모드

pnpm dev

테스트

pnpm test

MCP 클라이언트 설정

Claude Desktop 또는 다른 MCP 클라이언트에서 이 서버를 사용하려면, 설정 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "kpic": {
      "command": "node",
      "args": ["/path/to/kpic-mcp/dist/index.js"]
    }
  }
}

프로젝트 구조

kpic-mcp/
├── src/
│   ├── index.ts          # MCP 서버 메인 엔트리포인트
│   ├── kpic-api.ts       # KPIC API 클라이언트 함수
│   └── types.ts          # TypeScript 타입 정의
├── __tests__/
│   └── kpic-api.test.ts  # 테스트 코드
├── dist/                 # 빌드 결과물 (TypeScript 컴파일 후)
├── package.json
├── tsconfig.json
└── README.md

사용 예시

의약품 검색

// 타이레놀 검색
search_drugs_by_name("타이레놀")

상세 정보 조회

// 특정 의약품 코드로 상세 정보 조회
get_drug_detail_by_id("2013062800004")

기술 스택

  • Runtime: Node.js 18+

  • Language: TypeScript 5.x

  • Framework: MCP SDK (@modelcontextprotocol/sdk)

  • HTTP Client: Native Fetch API

  • Testing: Jest + ts-jest

  • Code Quality: ESLint, Prettier

  • Package Manager: pnpm

라이선스

MIT

주의사항

이 서버는 약학정보원의 공개 API를 사용합니다. API 사용 시 해당 사이트의 이용 약관을 준수해야 합니다.

Available Tools

2 tools
get_drug_detail_by_idA

약학정보원의 의약품 코드로 의약품의 상세정보를 가져옵니다. search_drugs_by_name()로 조회한 정보가 부족할 때 사용할 수 있습니다.

Inputs: drugcode (required).

search_drugs_by_nameA

약학정보원에서 의약품 이름으로 대략적인 정보들을 가져옵니다. 이름이 유사한 의약품 여러개가 나올 수 있습니다. 더 자세한 정보가 필요하다면 get_drug_detail_by_id()로 조회해야 합니다.

Inputs: drugname (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: search_drugs_by_name retrieves preliminary information by drug name, while get_drug_detail_by_id fetches detailed information by drug code. Their descriptions explicitly reference each other to clarify when to use which, eliminating any ambiguity.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun pattern (search_drugs_by_name and get_drug_detail_by_id), using snake_case and descriptive names that clearly indicate their functions and parameters. There are no deviations in naming style.

    Tool Count2/5

    With only 2 tools, the server feels under-scoped for a drug information domain. While the tools cover basic search and detail retrieval, typical drug information systems might include additional operations like filtering by category, checking interactions, or updating data, making this set appear thin and limited.

    Completeness2/5

    The tool set is severely incomplete for a drug information server. It lacks essential operations such as creating, updating, or deleting drug records, and does not cover common needs like drug interactions, dosage guidelines, or category-based searches. This will likely cause agent failures when more comprehensive tasks are required.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides access to the official FDA DailyMed database for comprehensive drug information, including drug labels, NDC codes, RxNorm mappings, pharmacologic classifications, and FDA application numbers through natural language queries.
      28
      3
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables users to understand lab test results, check food-drug interactions, and get medication information from official Korean sources. Offers personalized insights based on user's health profile and current medications.
      -