de en es ja ko ru zh

AgentLadle MCP CNINFO

Name: AgentLadle MCP CNINFO
Author: agentladle

by agentladle

Overview Schema Related Servers Score Discussions

Python

Local

AgentLadle MCP CNINFO

英語 | 中文

🇨🇳/🇭🇰 A株・香港上場企業向けクラウドホスト型MCP（過去3年間の年次報告書および最新の中間報告書）。詳細 | APIキー取得

中国A株の公告を発見・ダウンロード・解析・検索するためのツールを提供するMCP（Model Context Protocol）サーバーです。CNINFO（巨潮資訊網）からデータを取得します。

AIアシスタント（Claude、Cursorなど）が、6つの構造化ツールを通じてCNINFOの公告データにアクセスできるようにします。利用可能な公告の発見から、ページ内のキーワード検索までをカバーします。

スコープ（v0.1）： 公告のみ。定期報告（年報 / 半年報 / 一季報 / 三季報）は対象外です。

機能

6つのMCPツール：CNINFO公告データ用。状態駆動型の取得（直接検索し、必要な場合のみダウンロード/解析にフォールバック）
PDF文書解析：PyMuPDFを使用。物理ページをページ分割JSONに抽出
ローカルキーワード検索：TF + 位置ブーストスコアリング。外部検索依存なし
冪等性：ダウンロード/解析済みファイルは自動的にスキップ
ゼロ設定インストール：MCPクライアントに1行追加するだけ。クローンや手動設定は不要
純Python、クロスプラットフォーム（Windows / macOS / Linux）

Related MCP server: Chinese Stock MCP

前提条件

Python 3.10以上 — Pythonダウンロード
uv — uvインストール

注意： uvをインストールした後、ターミナルとMCPクライアント（例：Cherry Studio）を再起動して、uvコマンドが認識されるようにしてください。

クイックスタート

MCPクライアント設定（Claude Desktop、Cursorなど）に追加します：

{
  "mcpServers": {
    "mcp-cninfo": {
      "command": "uvx",
      "args": ["agentladle-mcp-cninfo"]
    }
  }
}

これだけです。uvxがPyPIからパッケージと依存関係を自動的にダウンロードします。クローンも手動インストールもパス設定も不要です。

代替：pip install

環境を自分で管理したい場合：

pip install agentladle-mcp-cninfo

次に設定：

{
  "mcpServers": {
    "mcp-cninfo": {
      "command": "agentladle-mcp-cninfo"
    }
  }
}

代替：ソースから実行（ローカル開発）

リポジトリをクローンして直接実行：

git clone https://github.com/agentladle/mcp-cninfo.git

次にMCPクライアントを設定：

{
  "mcpServers": {
    "mcp-cninfo": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp-cninfo", "agentladle-mcp-cninfo"]
    }
  }
}

/path/to/mcp-cninfo をクローンしたリポジトリの実際のパスに置き換えてください。

データフロー

CNINFO API                        Local Files (~/.agentladle/mcp-cninfo/data/)
──────────────                    ──────────────────────────────
szse_stock.json        ──→       companies.json               (stock_code→orgId mapping)
                                     │
hisAnnouncement/query  ──→        pdf/{LOCAL_KEY}/            (Tool 2: primary PDF/HTML + manifest)
                                     │
PyMuPDF parsing        ──→        json/*.json                 (Tool 3: parse, page-split)
                                     │
Local TF search        ──→        search results              (Tool 4: keyword search)
Page range read        ──→        page content                (Tool 5: read pages)

ツール

#	ツール	説明
1	`list_cninfo_announcements`	企業の利用可能なCNINFO公告を発見
2	`download_cninfo_announcement`	公告PDFをダウンロード（HTMLフォールバックあり）。冪等
3	`parse_cninfo_announcement`	PDF/HTMLをPyMuPDFを使用してページ分割JSONに解析
4	`keyword_search`	TF関連性スコアリングによる全文キーワード検索
5	`get_announcement_pages`	ページ番号範囲で公告コンテンツを読み取り
6	`lookup_stock_code`	診断用：解決失敗時にstock_code→orgIdマッピングを検索

ツール1：`list_cninfo_announcements`

企業の利用可能なCNINFO公告を一覧表示します。ユーザーが正確な日付/タイトルを指定していない場合、またはあいまいな一致によりダウンロード試行が失敗した場合にのみ、このツールを使用してください。デフォルトのカテゴリには定期報告（年報 / 半年報 / 一季報 / 三季報）は含まれません。

パラメータ	型	必須	説明
`stock_code`	string	✅	6桁の株式コード、例：`"000001"`
`category`	string	❌	カテゴリキー、短いコード、または中国語ラベル、例：`"董事会"`、`"DSH"`、`"category_dshgg_szsh"`。省略するとデフォルトの公告カテゴリを一覧表示
`start_date`	string	❌	開始日 `YYYY-MM-DD`
`end_date`	string	❌	終了日 `YYYY-MM-DD`
`title_keyword`	string	❌	タイトルキーワードフィルター
`limit`	int	❌	返す最大公告数、デフォルト10、最大50

ツール2：`download_cninfo_announcement`

static.cninfo.com.cnから特定のCNINFO公告をダウンロードします。利用可能な場合はlist_cninfo_announcementsのlocal_keyを優先します。冪等です。

パラメータ	型	必須	説明
`stock_code`	string	✅	6桁の株式コード、例：`"000001"`
`announce_date`	string	❌	公告日 `YYYY-MM-DD`（`local_key`が提供されている場合は任意）
`title_keyword`	string	❌	同日の公告を区別するためのタイトル部分文字列
`category`	string	❌	任意のカテゴリフィルター
`announcement_id`	string	❌	既知の場合のCNINFO公告ID
`local_key`	string	❌	リスト結果からの正確なローカルバンドルキー

ツール3：`parse_cninfo_announcement`

ダウンロードした公告PDF/HTMLをページ分割JSONに解析します。PDFの物理ページテキスト抽出にはPyMuPDFを使用します。

パラメータ	型	必須	説明
`local_key`	string	✅	リスト/ダウンロードで返されたバンドルキー、例：`"000001_DSH_2026-07-02_8b1ad607"`

ツール4：`keyword_search`

全ページにわたる全文キーワード検索。結果はTF + 位置ブーストスコアでランク付けされます。

パラメータ	型	必須	説明
`local_key`	string	✅	バンドルキー
`keywords`	string[]	✅	1〜5個の検索キーワード
`match_mode`	string	❌	`"ANY"`（デフォルト、いずれかのキーワードが一致）/ `"ALL"`（すべて一致）
`max_results`	int	❌	返す最大結果数、デフォルト5、最大50

ツール5：`get_announcement_pages`

ページ番号範囲で完全なページコンテンツを読み取ります。

パラメータ	型	必須	説明
`local_key`	string	✅	バンドルキー
`start_page`	int	✅	開始ページ番号（1始まり）
`page_count`	int	❌	返すページ数、デフォルト3、最大5

ツール6：`lookup_stock_code`

診断ツール：stock_code→orgIdマッピングを検索します。download_cninfo_announcement / list_cninfo_announcementsがStock code not foundを返した場合にのみ使用してください。セッションの失敗コードキャッシュをバイパスします。

パラメータ	型	必須	説明
`stock_code`	string	✅	6桁の株式コード、例：`"000001"`
`refresh`	bool	❌	CNINFOから`szse_stock.json`を強制的に再ダウンロード（デフォルト：`false`）

設定

初回実行時に、デフォルトの設定ファイルが~/.agentladle/mcp-cninfo/config.yamlに作成されます：

paths:
  data_dir: "~/.agentladle/mcp-cninfo/data"
  pdf_dir: "~/.agentladle/mcp-cninfo/data/pdf"
  json_dir: "~/.agentladle/mcp-cninfo/data/json"

download:
  delay_between_requests: 0.3
  min_file_size: 500
  list_page_size: 30
  list_max_pages: 5

company:
  cache_ttl_days: 7

データディレクトリ構造

~/.agentladle/mcp-cninfo/
├── config.yaml                        # Configuration (auto-created)
└── data/
    ├── companies.json                 # stock_code→orgId mapping (auto-downloaded & cached)
    ├── pdf/                           # Downloaded announcement bundles
    │   ├── 000001_DSH_2026-07-02_8b1ad607/
    │   │   ├── primary.pdf
    │   │   └── manifest.json
    │   └── ...
    └── json/                          # Parsed page-split JSON
        ├── 000001_DSH_2026-07-02_8b1ad607.json
        └── ...

ファイル命名規則： {STOCK_CODE}_{CAT_SHORT}_{ANNOUNCE_DATE}_{ID_HASH}

使用例

ツールは**EAFP（Easier to Ask for Forgiveness than Permission）**アプローチで設計されています。AIアシスタントは直接データを取得し、エラーに依存してダウンロードをトリガーする必要があります。

シナリオA：ファイルがローカルに既に存在する場合（最短パス）

User: "Search 000001 board resolution for 回购"

1. keyword_search(local_key="000001_DSH_2026-07-02_8b1ad607", keywords=["回购", "决议"])
   → Returns page snippets matching the keywords immediately.

シナリオB：ファイルが存在しない場合（フォールバックがトリガー）

User: "What did Ping An Bank announce in its latest board notice?"

1. list_cninfo_announcements(stock_code="000001", category="董事会", limit=3)
   → Returns local_key / announce_date / title.

2. keyword_search(local_key="...", keywords=["董事会", "决议"])
   → Error: File not found.

3. download_cninfo_announcement(stock_code="000001", local_key="...")
   → Downloads PDF to ~/.agentladle/mcp-cninfo/data/pdf/

4. parse_cninfo_announcement(local_key="...")
   → Parses into JSON.

5. keyword_search(local_key="...", keywords=["董事会", "决议"])
   → Retries search and returns data.

技術スタック

コンポーネント	選択	目的
MCPフレームワーク	`mcp` (FastMCP)	stdioトランスポートを使用したMCPサーバー
HTTPクライアント	`httpx`	CNINFO APIリクエストとファイルダウンロード
PDF解析	`pymupdf` + `beautifulsoup4`	PDFページテキスト抽出；HTMLフォールバック
検索	Python組み込み	TF + 位置ブーストスコアリング
設定	`pyyaml`	YAML設定ファイル

プロジェクト構造

src/mcp_cninfo/
├── __init__.py
├── server.py                 # MCP Server entry point
├── config.py                 # Config loading (~/.agentladle/mcp-cninfo/config.yaml, singleton cached)
├── models.py                 # Data models
├── categories.py             # Announcement category whitelist / blacklist
├── response.py               # Unified JSON responses
├── instances.py              # Service singletons
├── tools/
│   ├── list_announcements.py # Tool 1: list_cninfo_announcements
│   ├── download.py           # Tool 2: download_cninfo_announcement
│   ├── parse.py              # Tool 3: parse_cninfo_announcement
│   ├── search.py             # Tool 4: keyword_search
│   ├── page.py               # Tool 5: get_announcement_pages
│   └── lookup.py             # Tool 6: lookup_stock_code
└── services/
    ├── company.py            # CNINFO szse_stock.json + stock_code→orgId
    ├── downloader.py         # CNINFO query + PDF download
    ├── parser.py             # PDF/HTML→JSON parsing (PyMuPDF)
    ├── searcher.py           # Local JSON search + TF scoring
    └── keys.py               # local_key helpers

ライセンス

MIT

Available Tools

6 tools

download_cninfo_announcementA

Download a CNINFO announcement PDF (or HTML fallback) to local storage.

Args: stock_code: 6-digit stock code announce_date: YYYY-MM-DD (optional if local_key provided) title_keyword: Title substring to disambiguate same-day announcements category: Optional category filter announcement_id: CNINFO announcement id if known local_key: Exact local bundle key from list results

ParametersJSON Schema

Name	Required	Description	Default
`category`	No
`local_key`	No
`stock_code`	Yes
`announce_date`	No
`title_keyword`	No
`announcement_id`	No

Output Schema

ParametersJSON Schema

Name	Required	Description
`result`	Yes

TDQS

A4.6/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description discloses key behaviors: downloads to local storage, may fallback to HTML, and that periodic reports are out of scope. Also directs to call parse_cninfo_announcement after success. Lacks details on file storage location or overwrite behavior, but overall transparent.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Description is well-structured with labeled sections (<strategy>, <critical_rules>, Args). Front-loaded with core purpose. Every sentence contributes value. Slightly long but efficient for the complexity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no annotations and an output schema present, the description covers usage conditions, parameter details, relationship to siblings, and exclusions. It tells the agent when to invoke and what to do after success, making it fully contextualized.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description compensates by listing each parameter with brief but useful semantics: stock_code is 6-digit, announce_date is YYYY-MM-DD (optional if local_key), title_keyword disambiguates, etc. Adds meaning beyond schema names and types, though not extremely detailed.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it downloads a CNINFO announcement PDF (or HTML fallback) to local storage. It specifies the resource (CNINFO announcement) and action (download). Distinguishes from siblings by being a fallback tool and having explicit conditions for invocation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly states when to use: 'Invoke ONLY as a fallback when keyword_search / get_announcement_pages returns file not found, or after list when you have a concrete local_key / announcement_id.' Also provides critical rules about preferring local_key and that periodic reports are out of scope, giving clear guidance on alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_announcement_pagesA

Retrieve full page content for a range of pages from a parsed announcement.

Args: local_key: Bundle key start_page: 1-based start page page_count: Number of pages, default 3, max 5

ParametersJSON Schema

Name	Required	Description	Default
`local_key`	Yes
`page_count`	No
`start_page`	Yes

Output Schema

ParametersJSON Schema

Name	Required	Description
`result`	Yes

TDQS

A4.7/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries full burden. It adds behavioral context through strategy and critical rules (e.g., default page_count of 3, max 5). However, it does not mention error handling for invalid start_page or missing local_key, nor any authorization or rate limits. Still, the provided rules are helpful and non-contradictory.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with the core purpose, followed by a strategy section and critical rules. Each sentence adds value without redundancy. The Args section is cleanly organized. Length is appropriate for the tool's complexity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity (3 parameters, output schema present), the description covers purpose, usage, and parameters well. It omits error conditions or return format, but the output schema may provide that. Slightly lacking in describing what happens on failure, but overall adequate.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so description must add meaning. It does: local_key is 'bundle key', start_page is '1-based start page', page_count has default and max. This fully compensates for missing schema descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states 'Retrieve full page content for a range of pages from a parsed announcement.' This is a specific verb-resource pair, and it distinguishes from sibling tools like keyword_search (for specific facts) and download_cninfo_announcement (whole file).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The <strategy> explicitly instructs to invoke after keyword_search provides a start_page, and to not pre-check file existence. The <critical_rules> recommend preferring keyword_search for specific facts. This clearly guides when and how to use the tool, including exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

keyword_searchA

Search a parsed announcement by keywords. Results sorted by relevance.

Args: local_key: Bundle key from list/download keywords: 1-5 search keywords match_mode: "ANY" or "ALL", default ANY max_results: Max snippets, default 5, max 50

ParametersJSON Schema

Name	Required	Default
`keywords`	Yes
`local_key`	Yes
`match_mode`	No	ANY
`max_results`	No

Output Schema

ParametersJSON Schema

Name	Required	Description
`result`	Yes

TDQS

A4.4/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description bears full burden. It discloses sorting by relevance, match modes, default values, and max results limit. It also hints at error handling (prompt download/parse on missing file) but lacks details on edge cases like zero results.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Well-structured with strategy and rules sections. Each sentence adds value. The Args list is clear. The use of HTML-like tags adds structure but could be considered nonstandard; however, it aids readability and does not waste space.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Covers purpose, usage, parameters, and error handling. Given the existence of an output schema, lack of return format description is acceptable. However, it could mention snippet highlighting or result ordering more explicitly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0%, but the description fully explains all four parameters: local_key ('Bundle key from list/download'), keywords ('1-5 search keywords'), match_mode ('ANY or ALL, default ANY'), and max_results ('Max snippets, default 5, max 50'). This adds critical constraints and context beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states 'Search a parsed announcement by keywords' with specific verb and resource. It distinguishes from sibling tools like download, list, parse, etc., by focusing on searching within an already-parsed announcement.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides explicit strategy: 'Directly invoke this tool. Do not pre-check file existence' and suggests using Chinese financial terms. Critical rules specify passing 1-5 keywords and expanding synonyms. Though it doesn't explicitly state when not to use, the guidance is clear and actionable.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_cninfo_announcementsA

List available CNINFO A-share announcements for a company (excludes periodic reports).

Args: stock_code: 6-digit stock code, e.g. "000001" category: Optional CNINFO category key, short code, or Chinese label (e.g. "董事会", "DSH", "category_dshgg_szsh") start_date: YYYY-MM-DD inclusive end_date: YYYY-MM-DD inclusive title_keyword: Optional title search keyword limit: Max announcements to return, default 10, max 50

ParametersJSON Schema

Name	Required	Description	Default
`limit`	No
`category`	No
`end_date`	No
`start_date`	No
`stock_code`	Yes
`title_keyword`	No

Output Schema

ParametersJSON Schema

Name	Required	Description
`result`	Yes

TDQS

A4.8/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries full burden. It discloses that default categories exclude periodic reports and limit max is 50, which is good context. Could mention response format or pagination, but adequate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Well-structured with sections: purpose, strategy tag, critical rules, and args. Concise, front-loaded, every sentence valuable.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Covers purpose, usage, parameters, and constraints. Has output schema, so return values are documented elsewhere. Complete for a list tool with clear guidance.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, but description provides detailed parameter explanations: stock_code format, category examples, date format, title_keyword, limit defaults and max. Adds significant value beyond schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states it lists CNINFO A-share announcements (excluding periodic reports), and provides guidance to skip if user already has specific date and title, differentiating from siblings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly states when to use (to discover announce_date/local_key/title before download) and when to skip (if user provides specific date and title, go to keyword_search or download_cninfo_announcement).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

lookup_stock_codeA

Look up CNINFO orgId mapping for a 6-digit A-share stock code. Diagnostic tool.

Args: stock_code: 6-digit stock code, e.g. "000001" or "600519" refresh: Force re-download of szse_stock.json from CNINFO (default: false)

ParametersJSON Schema

Name	Required	Description	Default
`refresh`	No
`stock_code`	Yes

Output Schema

ParametersJSON Schema

Name	Required	Description
`result`	Yes

TDQS

A4.8/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must convey behavioral traits. It explains the tool is a diagnostic tool, describes the behavior of the refresh parameter (local cache vs re-download), and implies it is read-only by nature. However, it does not explicitly state that it is non-destructive, but the context suggests it is safe. The description adds sufficient behavioral context beyond the schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise and well-structured, with clear sections: main description, strategy, critical rules, and args. Every sentence is useful. It is front-loaded with the core purpose and quickly provides actionable guidance.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (2 parameters, output schema exists), the description covers all necessary aspects: purpose, usage guidelines, parameter details, and behavioral rules. It is complete for an agent to correctly select and invoke the tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0%, so the description provides all parameter semantics. It explains stock_code as '6-digit stock code, e.g. "000001" or "600519"' and refresh as 'Force re-download of szse_stock.json from CNINFO (default: false)'. This adds meaningful examples and behavior beyond the schema's type/title fields.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Look up CNINFO orgId mapping for a 6-digit A-share stock code. Diagnostic tool.' The verb 'look up' and resource 'CNINFO orgId mapping' are specific. It is distinguished from sibling tools (e.g., download_cninfo_announcement) which deal with announcements, not code mappings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description includes a <strategy> section explicitly stating when to invoke: 'Invoke ONLY when download/list returns "Stock code not found". After success, retry the original list/download call.' It also provides critical rules about preferring refresh=false first. This gives clear when-to-use and when-not-to-use guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

parse_cninfo_announcementA

Parse a downloaded announcement PDF/HTML into page-split JSON.

Args: local_key: Bundle key returned by list/download, e.g. "000001_DSH_2024-04-30_a1b2c3d4"

ParametersJSON Schema

Name	Required	Description	Default
`local_key`	Yes

Output Schema

ParametersJSON Schema

Name	Required	Description
`result`	Yes

TDQS

A4.4/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations exist, so the description carries full burden. It describes the transformation but does not disclose potential side effects, error behavior, or safety (e.g., idempotency, permissions). Adequate but not detailed.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise with a main sentence, a strategy block, and argument explanation. No unnecessary words; front-loaded with purpose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with one parameter and an output schema, the description provides enough context for usage and timing. Minor gaps on failure behavior, but overall complete given the simple interface.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema coverage is 0%, but the description explains the parameter local_key as a bundle key with an example. This adds significant meaning beyond the schema's bare type and title.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool parses downloaded announcement PDF/HTML into page-split JSON. It uses a specific verb and resource, and the strategy section distinguishes it from sibling tools like download_cninfo_announcement.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The strategy explicitly says to call after a successful download or when JSON is missing. This provides clear when-to-use and when-not-to-use guidance, differentiating from other tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

TDQS

A4.6/5.0

Disambiguation5/5

Each tool has a distinct role: listing, downloading, parsing, searching, page retrieval, and stock code lookup. No overlap in functionality, making it easy for an agent to select the correct tool.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern in snake_case (e.g., list_cninfo_announcements, download_cninfo_announcement, lookup_stock_code). Minor variation in verb choice ('lookup' vs 'list') is negligible.

Tool Count5/5

With 6 tools covering the core workflow of discovering, downloading, parsing, and searching announcements, the count is well-scoped and avoids bloat. Each tool serves a necessary step in the process.

Completeness4/5

The tool set covers the primary lifecycle: list, download, parse, keyword search within a document, and page retrieval. Missing a cross-announcement search or category listing, but these are minor gaps that do not break the workflow.

Maintenance

ActivityMaintained

ResponsivenessSyncing

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Related MCP Connectors

Wudao A-Share Stock Data MCP
io.github.jcdreamjc
Read-only China A-share data for AI agents: market, limit-up, capital flow and disclosures.
Finance Research & Data
211
QuantSonar B
io.github.QuantSonar
China A-share market data for research, backtesting and AI agents via MCP.
Finance Research & Data
451
zwldarren-akshare-one-mcp BOAuth
ai.smithery
Provide access to Chinese stock market data including historical prices, real-time data, news, and…
Finance Search Open Data
3225
china-market-intelligence-mcp
com.thenextgennexus
MCP server giving AI agents one-connection access to China A-share market intelligence: financials,
Finance Research & Data
2

Related MCP Servers

AgentSkills MCP
Finance Web Scraping Search
zouyingcao
A
license
B
quality
D
maintenance
Provides comprehensive financial research tools including A-share stock analysis, web scraping, entity extraction, and multi-source search capabilities for building intelligent financial research agents.
Updated 9 months ago (2025-12-16 13:22 UTC)
4
25
Apache 2.0
Chinese Stock MCP
Finance Search Research & Data
hwibalyu
F
license
Not graded
quality
D
maintenance
Provides real-time quotes, fund flows, and corporate announcements for Chinese A-share stocks. It enables users to search for stocks, analyze financial indicators, and summarize quarterly reports through natural language.
Updated 6 months ago (2026-03-18 05:16 UTC)
a-share-mcp
Finance Research & Data
kissjerryfan
A
license
Not graded
quality
D
maintenance
Enables users to query Chinese A-share stock data, including stock basics, historical prices, financial reports, and macroeconomic indicators.
Updated a year ago (2025-07-17 02:46 UTC)
1
MIT
AKShare MCP Server
Finance Open Data
jadenmong
A
license
B
quality
D
maintenance
Enables AI assistants to access comprehensive Chinese financial market data including stocks, funds, futures, and economic indicators via AKShare.
Updated 4 months ago (2026-04-24 11:15 UTC)
5
6
MIT

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

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/agentladle/mcp-cninfo'

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

AgentLadle MCP CNINFO

機能

前提条件

クイックスタート

代替：pip install

代替：ソースから実行（ローカル開発）

データフロー

ツール

ツール1：list_cninfo_announcements

ツール2：download_cninfo_announcement

ツール3：parse_cninfo_announcement

ツール4：keyword_search

ツール5：get_announcement_pages

ツール6：lookup_stock_code

設定

データディレクトリ構造

使用例

技術スタック

プロジェクト構造

ライセンス

Available Tools

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Maintenance

Resources

Looking for Admin?

Related MCP Connectors

Related MCP Servers

Latest Blog Posts

MCP directory API

ツール1：`list_cninfo_announcements`

ツール2：`download_cninfo_announcement`

ツール3：`parse_cninfo_announcement`

ツール4：`keyword_search`

ツール5：`get_announcement_pages`

ツール6：`lookup_stock_code`