FinData MCP Server

FinData MCP Server

Open-source MCP server for LLM access to professional financial data.

45
Stars
10
Forks
45
Watchers
2
Issues
FinData MCP Server offers standardized financial data access to large language models by implementing the Model Context Protocol. It supports multiple data providers such as Tushare and Wind, and enables retrieval of both market and macroeconomic data via Stdio or SSE transports. The server is configurable and integrates into AI systems, providing tools for market, fundamental, and financial data queries.

Key Features

Implements the Model Context Protocol (MCP) for AI model context transactions
Supports Stdio and SSE transports for flexible communication
Integrates with multiple financial data providers such as Tushare
Configurable via environment variables and client configuration
Provides access to market, fundamental, and macroeconomic data
Supports Python 3.11 and modern dependency management
Offers demo and quick start setup instructions
Modular design supporting new data providers
Detailed toolset for financial queries (e.g., stock info, balancesheet, macro indices)
Flexible deployment options suitable for AI server environments

Use Cases

Enhancing LLM applications with up-to-date financial and macroeconomic data
Serving as a data backend for AI-powered financial analytics tools
Automated stock market analysis and reporting using LLMs
Embedding real-time financial context in conversational AI agents
Supporting research projects requiring structured financial datasets
Providing LLM chatbots with direct access to stock, company, and macroeconomic data
Integrating with AI tools for data-driven investment analysis
Enabling easy switching between different financial data providers in AI workflows
Finance education and simulation systems powered by model-contextualized data
Building custom dashboards or assistants for financial professionals using LLMs

README

English English License Python Versions Tushare

Overview

FinData is an open-source Model Context Protocol(MCP) Server that provides professional financial data access capabilities for LLM. It supports various data providers such as Tushare, Wind, DataYes, etc. This enables AI applications to quickly retrieve financial data.

Fully supports both Stdio and SSE transports, offering flexibility for different environments.

Demonstration

https://github.com/user-attachments/assets/1a6d02af-22a3-44a0-ada7-a771a1c4818d

Quick Start

Prerequisites

Before getting started, please complete the following preparations:

  • python => 3.11
  • mcp[cli]>=1.6.0
  • pandas>=2.2.3
  • uv

Depending on your data provider, install optional packages such as:

  • tushare>=1.4.21

Configuration

Stdio Transport

You will need to edit the MCP client configuration file to add finData:

JSON
{
  "mcpServers": {
    "finData": {
      "command": "uv", 
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/finData-mcp-server/src/findata", 
        "run",
        "server.py"
      ],
      "env": {
        "DATA_API_TOKEN": "",  // API Token for accessing data provider
        "PROVIDER": "tushare"  // Specified data provider
      }
    }
  }
}

SSE Transport

Set the environment variables DATA_API_TOKEN and PROVIDER on the server hosting the MCP Server:

Windows

bash
 set DATA_API_TOKEN=<API Token for accessing data provider>
 set PROVIDER=<Specified data provider>

Linux

bash
  export DATA_API_TOKEN=<API Token for accessing data provider>
  export PROVIDER=<Specified data provider>

Then, start the MCP Server:

bash
uv run server.py --transport sse   
  • Optional Arguments:

    --sse-host Host to bind SSE server to (default: localhost)

    --sse-port Port for SSE server (default: 8000)

Once the MCP Server is running, update your MCP client's configuration with the following settings to connect to it.

JSON
{
  "mcpServers": {
    "finData": {
      "name": "finData",
      "type": "sse",
      "baseUrl": "http://localhost:8000/sse"
    }
  }
}

Note: Variable names in configuration files may vary slightly between MCP clients. Refer to each client's documentation for proper configuration.

Supported Data Providers

Set the PROVIDER environment variable to specify your provider:

  • tushare

Tools

Tushare

Market Data

  • daily Get unadjusted daily stock market data.

Fundamental Data

  • stock_basic Get stock basic information including name, code, etc.
  • stock_company Get listed company basic information.
  • bak_basic Get fundamental data for specific stocks within a given time range.

Financial Data

  • income Get company income statement data.
  • balancesheet Get company balance sheet data.
  • cashflow Get company cash flow statement data.

Macroeconomic Data

  • shibor_lpr Get Loan Prime Rate (LPR) data.
  • cn_gdp Get Gross Domestic Product (GDP) data.
  • cn_cpi Get Consumer Price Index (CPI) data.
  • cn_ppi Get Producer Price Index (PPI) data.
  • cn_m Get Money Supply data.
  • sf_month Get Social Financing data.
  • cn_pmi Get Purchasing Managers' Index (PMI) data.

DataCanvas

datacanvas

This project is open-sourced by DataCanvas

Star History

Star History Chart

Repository Owner

zlinzzzz
zlinzzzz

User

Repository Details

Language Python
Default Branch master
Size 35,594 KB
Contributors 1
License Apache License 2.0
MCP Verified Nov 12, 2025

Programming Languages

Python
100%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Macrocosmos MCP

    Macrocosmos MCP

    Official Model Context Protocol server for real-time social and video data integration.

    Macrocosmos MCP is the official server implementation of the Model Context Protocol (MCP). It connects AI clients with real-time data from platforms like X, Reddit, and YouTube, powered by Data Universe (SN13) on Bittensor. The server enables MCP-compatible clients to fetch social media and video transcript data for enhanced contextual understanding. It supports integration with tools such as Claude Desktop, Cursor, Windsurf, and OpenAI Agents.

    • 24
    • MCP
    • macrocosm-os/macrocosmos-mcp
  • Aviationstack MCP Server

    Aviationstack MCP Server

    MCP server offering comprehensive endpoints for aviation and flight data.

    Aviationstack MCP Server provides an MCP-compliant API that exposes tools to access real-time and scheduled flight data, aircraft details, random aircraft types, countries, and city information from the AviationStack API. It offers ready-to-use endpoints for airline-specific flight queries, airport schedules, and in-depth vehicle, country, and city data. The solution applies the Model Context Protocol by defining MCP tools as Python functions with standardized interfaces, designed for seamless integration into MCP-compatible environments. The server is built using Python, incorporates the FastMCP library, and is intended for easy deployment and use in application development.

    • 11
    • MCP
    • Pradumnasaraf/aviationstack-mcp
  • amazon-ads-mcp-server

    amazon-ads-mcp-server

    Stream Amazon Advertising data into MCP-compatible AI clients.

    amazon-ads-mcp-server enables seamless integration of Amazon Advertising data—including campaigns, keywords, reports, and more—into any Model Context Protocol (MCP) compatible client. It provides both local and HTTP-based MCP server implementations for usage across desktops and platforms such as Claude Desktop and LibreChat. With support for plain English querying of reports and enhanced features like recommendations and experiments (with subscription), the tool facilitates streamlined access and interaction with Amazon Ads data for model-based workflows.

    • 18
    • MCP
    • MarketplaceAdPros/amazon-ads-mcp-server
  • Weather MCP Server

    Weather MCP Server

    A Model Context Protocol server delivering weather and air quality data via multiple transport modes.

    Weather MCP Server is a Model Context Protocol (MCP) implementation that provides comprehensive weather and air quality information using the Open-Meteo API. It supports various transport modes including standard stdio for desktop clients, HTTP Server-Sent Events (SSE), and Streamable HTTP for modern web integration. The server offers both real-time and historical weather metrics, as well as timezone and time conversion functionalities. Installation and integration options are available for both MCP desktop clients and web applications.

    • 26
    • MCP
    • isdaniel/mcp_weather_server
  • ws-mcp

    ws-mcp

    WebSocket bridge for MCP stdio servers.

    ws-mcp wraps Model Context Protocol (MCP) stdio servers with a WebSocket interface, enabling seamless integration with web-based clients and tools. It allows users to configure and launch multiple MCP servers via a flexible configuration file or command-line arguments. The tool is designed to be compatible with services such as wcgw, fetch, and other MCP-compliant servers, providing standardized access to system operations, HTTP requests, and more. Integration with tools like Kibitz enables broader applications in model interaction workflows.

    • 19
    • MCP
    • nick1udwig/ws-mcp
  • Fantasy Premier League MCP Server

    Fantasy Premier League MCP Server

    Enables rich access to Fantasy Premier League data via the Model Context Protocol.

    Fantasy Premier League MCP Server is a Model Context Protocol (MCP) server that provides streamlined access to Fantasy Premier League (FPL) data, including player statistics, team information, and gameweek details. It allows users to interact with and compare FPL player data, search teams and players, and integrate seamlessly with Claude Desktop and other MCP-compatible clients. Designed for both quick CLI usage and deep AI integration, it ensures comprehensive coverage for FPL enthusiasts and AI-powered desktop tools.

    • 65
    • MCP
    • rishijatia/fantasy-pl-mcp
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results