Skip to main content
Glama
memorise8

dart-search-mcp

by memorise8

dart-search-mcp

한국 금융감독원 전자공시시스템(DART) Open API를 MCP 서버와 CLI로 사용할 수 있게 해주는 도구입니다.

공시 검색, 기업 개황, 재무제표, 재무지표, 지분공시, 정기보고서 주요정보, 주요사항보고서, 증권신고서, 원문 ZIP, XBRL ZIP 다운로드를 지원합니다.

빠른 시작

  1. DART Open API 키를 발급합니다.

  2. 환경 변수를 설정합니다.

export DART_API_KEY="your_api_key_here"
  1. 의존성을 설치합니다.

uv sync
  1. 로컬 상태를 점검합니다.

uv run dart diagnostics

정상적으로 로드되면 Python 버전, 패키지 상태, API 키 설정 여부, MCP 도구 수, CLI 명령 수가 출력됩니다. API 키 값은 출력하지 않습니다.

Related MCP server: OpenDart-MCP

MCP 서버 실행

uv run dart serve

또는 호환 엔트리포인트로 직접 실행할 수 있습니다.

uv run python server.py

MCP 클라이언트 설정 예시

Claude Desktop 등 MCP 클라이언트에는 이 저장소의 절대 경로를 넣어 연결합니다.

{
  "mcpServers": {
    "dart-search": {
      "command": "uv",
      "args": ["run", "python", "/absolute/path/to/dart-search-mcp/server.py"],
      "env": {
        "DART_API_KEY": "your_api_key_here"
      }
    }
  }
}

CLI 사용법

uv run dart search 삼성전자
uv run dart company 00126380
uv run dart disclosures --corp 삼성전자 --from 20240101 --to 20241231 --type A
uv run dart financial 00126380 2024
uv run dart financial-full 00126380 2024 --fs CFS
uv run dart indicators 00126380 2024 --class M210000
uv run dart multi-financial 00126380,00164779 2024
uv run dart shareholders 00126380
uv run dart periodic 00126380 2024 배당
uv run dart event 00126380 유상증자결정
uv run dart securities 00126380 지분증권

전체 CLI 명령 목록은 docs/cli.md에 생성되어 있습니다.

XBRL 사용법

XBRL 재무제표 원본 ZIP은 download-xbrl 명령 또는 MCP 도구 download_xbrl로 내려받습니다.

uv run dart download-xbrl 00126380 2024 --report 11011 -o ./downloads

보고서 코드는 다음 값을 사용합니다.

  • 11011: 사업보고서

  • 11012: 반기보고서

  • 11013: 1분기보고서

  • 11014: 3분기보고서

접수번호를 알고 있으면 MCP 도구에서는 rcept_no를 직접 지정할 수 있습니다. 접수번호를 모르면 corp_code, bsns_year, reprt_code로 정기공시 목록에서 자동 조회합니다.

XBRL 표준계정과목체계는 다음처럼 조회합니다.

uv run dart taxonomy BS1

지원 양식은 BS1, BS2, BS3, IS1, IS2, IS3, IS4, CIS1, CIS2, CIS3, CIS4, DC1, DC2입니다.

MCP 도구

현재 MCP 서버는 16개 도구를 제공합니다.

  • 공시/기업: search_disclosures, search_corp_code, get_company_info

  • 재무: get_financial_statements, get_financial_statements_full, get_multi_company_financials

  • 지표: get_financial_indicators, get_multi_company_indicators

  • 지분공시: get_major_shareholders_report, get_executive_stock_report

  • 보고서 주요정보: get_periodic_report, get_major_event_report, get_securities_report

  • 다운로드/XBRL: download_document, download_xbrl, get_xbrl_taxonomy

전체 MCP 도구 목록은 docs/tools.md에 생성되어 있습니다.

개발 및 검증

문서를 현재 CLI/MCP 표면에서 다시 생성합니다.

uv run python scripts/generate_docs.py

문서 drift를 포함한 로컬 QA를 실행합니다.

uv run python scripts/qa.py

개별 테스트만 실행하려면 다음 명령을 사용합니다.

uv run python -m unittest discover -v
Install Server
F
license - not found
A
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/memorise8/dart-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server