mcp_zhitou_server

What is mcp_zhitou_server?

mcp_zhitou_server is a Python-based Model Context Protocol (MCP) server that acts as a bridge between AI agents (such as Cursor and Cline) and the Zhitou HS Data API. It provides real-time China A‑share stock market data, allowing users to query stock lists, company profiles, capital flows, and more directly through natural language in an AI agent’s chat interface.

How to use mcp_zhitou_server?

Install Python 3.8+, the requests library, obtain a Zhitou API token, and download the single script file mcp_zhitou_server.py. Replace the placeholder token in the script with your real API token, then configure the MCP client (Cursor or Cline) by specifying the command to run the script. After setup, use natural language in the AI agent to invoke the available tools.

Key features of mcp_zhitou_server

• MCP standard implementation via stdio and JSON-RPC
• Direct integration with Zhitou HS Data API
• Written in Python for easy extension
• Plug‑and‑play setup with clear configuration guides
• Tool encapsulation for common Zhitou API endpoints
• Basic logging and error handling for debugging

Use cases of mcp_zhitou_server

• Query the latest A‑share stock list (code, name, exchange)
• Retrieve company profiles for a given stock code
• Check new stock calendar (IPO subscription dates, listing dates)
• Analyze daily capital inflow trends for a stock (last decade)
• Fetch all historical announcements for a specific stock

FAQ from mcp_zhitou_server

What are the runtime requirements?

Python 3.8 or higher, the requests library, a valid Zhitou API token, and an MCP‑compatible client (Cursor or Cline).

How do I get the API token?

Register at Zhitou (https://www.zhituapi.com/) and obtain your personal API token. Replace the placeholder "ZHITU_TOKEN_LIMIT_TEST" in the script with your token.

What tools are available?

Current tools include get_stock_list, get_new_stock_calendar, get_company_profile, get_capital_daily_trend, and get_all_announcements. Additional tools can be added by extending the script.

How do I configure mcp_zhitou_server for Cursor?

Create a .cursor/mcp.json file in your project root with the command and script path, and optionally declare the tools. Example JSON is provided in the README.

How do I configure mcp_zhitou_server for Cline?

In Cline’s MCP Servers settings, add a new server with a name, and set the command to the full Python interpreter path and the absolute path to the script.