Mcp Opendart Server

io.github.kcw2034-sayouzone由 GitHub 帳號 kcw2034-sayouzone 發布v0.0.4更新於 Oct 24, 2026

An MCP server that provides OpenDart API

已驗證STDIO僅桌面金融資料與分析

概覽

AI 產生的概覽

一個本機 MCP 伺服器，讓助理透過 OpenDART API 取得韓國股票基本面、財務報表與股利資料。

可以做什麼
依公司名稱（例如三星電子）取得 OpenDART 的基本面與股票基本資訊，可依年份與季度查詢（例如 2025 年第三季）。查詢公司的財務報表與財務狀況。查詢股利資訊與股利發放趨勢。README 的套件結構另列出公告、股權、證券申報書與定期報告主要事項的解析器，但未公布具體工具清單。
適用情境
適合讓助理以 OpenDART 官方資料回答韓國上市公司的財務、股利或公告問題，而非依賴一般網路來源。
執行需求
以本機程序執行（PyPI 套件 sayou-opendart-mcp，stdio 傳輸）。需透過 OPENDART_API_KEY 環境變數提供 OpenDART API 金鑰，並需要連線至 OpenDART 服務的網路存取。僅限桌面端，沒有網頁可執行版本。
安裝前請注意
伺服器需要以 OPENDART_API_KEY 提供 OpenDART API 金鑰，請勿寫入共用設定或日誌。查詢內容會傳送至外部 OpenDART 服務。README 另展示選用的 Cloud Run 部署步驟，涉及 Google Cloud 服務帳戶與身分權杖，本機使用不需要這些。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Opendart Server，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

OpenDart MCP Server

OpenDart Crawling and Caching MCP Server

주식 정보를 OpenDart에서 종목 기본 정보 (펀더멘탈, fundamental)를 가져온다.

모델 컨텍스트 프로토콜 (Model Context Protocol, MCP) 서버를 빌도하고 배포
MCP 서버는 LLM에 외부 도구 및 서비스에 대한 액세스 권한을 제공
FastMCP를 사용, MCP 서버와 클라이언트를 빌드하는 빠르고 Pythonic한 방법을 제공

  • Gemini 3.0 Pro
  • Gemini 3.0 Flash
참조 문서

패키지 구조

├── opendart/│   ├── __init__.py          # 공개 API 정의│   ├── client.py            # OpenDART HTTP 클라이언트│   ├── models.py            # 데이터 클래스 (DTO)│   ├── utils.py             # 유틸리티 함수 & 상수│   ├── crawler.py           # 통합 인터페이스 (Facade)│   ├── examples.py          # 사용 예시│   └── parsers/│       ├── __init__.py│       ├── document.py        # 문서 API 파서│       ├── document_viewer.py # 문서 뷰어 API 파서│       ├── disclosure.py      # 공시정보 API 파서│       ├── finance.py         # 정기보고서 재무정보 API 파서│       ├── material_facts.py  # 주요사항보고서 주요정보 API 파서│       ├── ownership.py       # 지분공시 종합정보 API 파서│       ├── registration.py    # 증권신고서 주요정보 API 파서│       └── reports.py         # 정기보고서 주요정보 API 파서├── tests/│   ├── test_opendart.py       # OpenDART 테스트 (로컬 소스)│   └── test_opendart_.py      # OpenDART 테스트 (sayou-stock)├── __init__.py├── .gitignore├── Dockerfile├── LICENSE├── opendarts.py├── pyproject.toml├── README.md├── requirements.txt└── server.py

배포 (Cloud Run)

bash
MCP_SERVER_NAME=opendart-mcp-serverexport GOOGLE_CLOUD_PROJECT=sayouzone-ai
GCP 설정 (1회만)

서비스 활성화

bash
gcloud services enable \  run.googleapis.com \  artifactregistry.googleapis.com \  cloudbuild.googleapis.com

서비스 계정 생성

bash
gcloud iam service-accounts create mcp-server-sa --display-name="MCP Server Service Account"
bash
gcloud projects add-iam-policy-binding $GOOGLE_CLOUD_PROJECT \    --member=user:$(gcloud config get-value account) \    --role='roles/run.invoker'
bash
gcloud projects add-iam-policy-binding $GOOGLE_CLOUD_PROJECT \    --member=serviceAccount:mcp-server-sa@$GOOGLE_CLOUD_PROJECT.iam.gserviceaccount.com \    --role="roles/secretmanager.secretAccessor"
배포

패키지 소스로 테스트

bash
gcloud run deploy $MCP_SERVER_NAME \    --service-account=mcp-server-sa@$GOOGLE_CLOUD_PROJECT.iam.gserviceaccount.com \    --no-allow-unauthenticated \    --region=us-central1 \    --source=. \    --labels=dev-tutorial=stocks-mcp

패키지 소스 및 접근권한 테스트

bash
gcloud run deploy $MCP_SERVER_NAME \    --region=us-central1 \    --source=. \    --labels=dev-tutorial=stocks-mcp

sayou-stock 설치 및 테스트

bash
gcloud run deploy $MCP_SERVER_NAME \    --service-account=mcp-server-sa@$GOOGLE_CLOUD_PROJECT.iam.gserviceaccount.com \    --no-allow-unauthenticated \    --region=us-central1 \    --source=. \    --labels=dev-tutorial=stocks-mcp

sayou-stock 설치 및 접근권한 테스트

bash
gcloud run deploy $MCP_SERVER_NAME \    --region=us-central1 \    --source=. \    --labels=dev-tutorial=stocks-mcp

Tests

Gemini 테스트
bash
export PROJECT_NUMBER=$(gcloud projects describe $GOOGLE_CLOUD_PROJECT --format="value(projectNumber)")export ID_TOKEN=$(gcloud auth print-identity-token)

settings.json

json
{    "ide": {        "hasSeenNudge": true    },    "mcpServers": {        "opendart-remote": {            "httpUrl": "https://opendart-mcp-server-$PROJECT_NUMBER.us-central1.run.app/mcp",            "headers": {                "Authorization": "Bearer $ID_TOKEN"            }        }    },    "security": {        "auth": {            "selectedType": "gemini-api-key"        }    }}

Copy settings.json file to ~/.gemini/ directory.

bash
cp settings.json ~/.gemini/
bash
gemini
  • 삼성전자
  • 삼성전자 재무제표 보여줘
  • 삼성전자 재무 상태를 보여줘
  • 삼성전자 재무제표 보여줘
  • 2024년 삼성전자 재무제표 보여줘
  • 2025년 3분기 삼성전자 재무제표 보여줘
  • 삼성전자 배당 정보를 보여줘
  • 삼성전자 배당에 대해 알려줘
  • 삼성전자 배당이 어떻게 되지?
  • 2025년 삼성전자 배당이 어떻게 되지?
  • 삼성전자 최근 배당 성향에 대해 알려줘
  • 삼성전자가 지급하는 보상에 대해 알려줘
bash
Loaded cached credentials.
 ███            █████████  ██████████ ██████   ██████ █████ ██████   █████ █████░░░███         ███░░░░░███░░███░░░░░█░░██████ ██████ ░░███ ░░██████ ░░███ ░░███  ░░░███      ███     ░░░  ░███  █ ░  ░███░█████░███  ░███  ░███░███ ░███  ░███    ░░░███   ░███          ░██████    ░███░░███ ░███  ░███  ░███░░███░███  ░███     ███░    ░███    █████ ░███░░█    ░███ ░░░  ░███  ░███  ░███ ░░██████  ░███   ███░      ░░███  ░░███  ░███ ░   █ ░███      ░███  ░███  ░███  ░░█████  ░███ ███░         ░░█████████  ██████████ █████     █████ █████ █████  ░░█████ █████░░░            ░░░░░░░░░  ░░░░░░░░░░ ░░░░░     ░░░░░ ░░░░░ ░░░░░    ░░░░░ ░░░░░
Tips for getting started:1. Ask questions, edit files, or run commands.2. Be specific for the best results.3. Create GEMINI.md files to customize your interactions with Gemini.4. /help for more information.
╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮│ Gemini CLI update available! 0.14.0 → 0.15.0                                                                            ││ Installed via Homebrew. Please update with "brew upgrade".                                                              │╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

⠋ Connecting to MCP servers... (1/2)
 Using: 2 MCP servers╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮│ >   Type your message or @path/to/file                                                                                  │╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ ~/.../src/sayou/mcp/stocks_mcp (main*)                                      no sandbox (see /docs)                                       auto

Deploy sayou-stock

bash
git push origin maingit tag sayou-stock-v0.1.1git push origin sayou-stock-v0.1.1

Errors

bash
> /mcp
Configured MCP servers:
🟢 stocks-remote - Ready (4 tools)  Tools:  - find_fnguide_data  - find_yahoofinance_data  - get_yahoofinance_fundamentals  - save_fundamentals_data_to_gcs
🟢 zoo-remote - Ready (2 tools, 1 prompt)  Tools:  - get_animal_details  - get_animals_by_species  Prompts:  - find

ℹ Gemini CLI update available! 0.14.0 → 0.15.0  Installed via Homebrew. Please update with "brew upgrade".
 Using: 2 MCP servers╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮│ >   Type your message or @path/to/file                                                                                  │╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ ~/.../src/sayou/mcp/stocks_mcp (main*)                     no sandbox (see /docs)                                     auto
bash
> 삼성전자
ℹ Gemini CLI update available! 0.14.0 → 0.15.0  Installed via Homebrew. Please update with "brew upgrade".╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮│ x  find_fnguide_data (stocks-remote MCP Server) {"stock":"삼성전자"}                                                      ││                                                                                                                         ││    MCP tool 'find_fnguide_data' reported tool error for function call: {"name":"find_fnguide_data","args":{"stock":"삼성전자"}} with  ││    response: [{"functionResponse":{"name":"find_fnguide_data","response":{"error":{"content":[{"type":"text","text":"Error calling tool ││    'find_fnguide_data': BrowserType.launch: Executable doesn't exist at                                                                     ││    /root/.cache/ms-playwright/chromium_headless_shell-1194/chrome-linux/headless_shell\n╔══════════════════════════════════════════════════ ││    ══════════╗\n║ Looks like Playwright was just installed or updated.       ║\n║ Please run the following command to download new          ││    browsers: ║\n║                                                            ║\n║     playwright install                                    ││    ║\n║                                                            ║\n║ <3 Playwright Team                                                  ││    ║\n╚════════════════════════════════════════════════════════════╝"}],"isError":true}}}}]                                                 │╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮│ -  Shell playwright install [current working directory /Users/seongjungkim/Development/sayouzone/base-framework/src/sayou/mcp/stocks_mcp] … │╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

References

來源：README.md，提交 31963b2

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.0.4最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分