MCP Opendart Server

🚀 OpenDart MCP 服務器

OpenDart MCP 服務器用於爬取和緩存數據，它可以從 OpenDart 獲取股票的基本信息（基本面數據）。同時，該服務器基於模型上下文協議（Model Context Protocol, MCP）構建和部署，為大語言模型（LLM）提供訪問外部工具和服務的權限。藉助 FastMCP，能夠以快速且符合 Python 風格的方式構建 MCP 服務器和客戶端。支持的模型包括 Gemini 3.0 Pro 和 Gemini 3.0 Flash。

✨ 主要特性

• 從 OpenDart 獲取股票的基本信息（基本面）。
• 構建和部署 MCP 服務器，為 LLM 提供外部工具和服務的訪問權限。
• 使用 FastMCP 快速構建 MCP 服務器和客戶端。
• 支持 Gemini 3.0 Pro 和 Gemini 3.0 Flash 模型。

📦 安裝指南

部署（Cloud Run）

環境變量設置

MCP_SERVER_NAME=opendart-mcp-server
export GOOGLE_CLOUD_PROJECT=sayouzone-ai

GCP 配置（僅需執行一次）

• 啟用服務

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

• 創建服務賬戶

gcloud iam service-accounts create mcp-server-sa --display-name="MCP Server Service Account"

• 添加 IAM 策略綁定

gcloud projects add-iam-policy-binding $GOOGLE_CLOUD_PROJECT \
    --member=user:$(gcloud config get-value account) \
    --role='roles/run.invoker'

gcloud projects add-iam-policy-binding $GOOGLE_CLOUD_PROJECT \
    --member=serviceAccount:mcp-server-sa@$GOOGLE_CLOUD_PROJECT.iam.gserviceaccount.com \
    --role="roles/secretmanager.secretAccessor"

部署命令

• 使用包源進行測試

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

• 測試包源和訪問權限

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

• 安裝並測試 sayou-stock

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 訪問權限

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

📚 詳細文檔

包結構

├── opendart/
│   ├── __init__.py          # 定義公開 API
│   ├── client.py            # OpenDART HTTP 客戶端
│   ├── models.py            # 數據類 (DTO)
│   ├── utils.py             # 實用函數和常量
│   ├── crawler.py           # 集成接口 (外觀模式)
│   ├── 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

部署 sayou-stock

git push origin main
git tag sayou-stock-v0.1.1
git push origin sayou-stock-v0.1.1 

測試

Gemini 測試

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

settings.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"
        }
    }
}

複製配置文件

cp settings.json ~/.gemini/

運行 Gemini

gemini

錯誤信息

> /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

> 삼성전자

ℹ 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] … │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

📄 許可證

本項目包含 LICENSE 文件，具體許可信息請查看該文件。

🔗 參考文檔

• 如何在 Cloud Run 上部署安全的 MCP 服務器
• Gemini CLI: 自定義斜槓命令
• 在 Cloud Run 上使用 MCP 服務器構建和部署 ADK 代理