Finance Market Data MCP server for AI agents

FinanceMCP is a professional financial data server based on the Model Context Protocol (MCP). It integrates with Tushare API to provide real-time financial data and technical indicator analysis capabilities to AI assistants like Claude, allowing them to access and analyze financial information through natural language queries.

Getting Started

Using the Public Service

The simplest way to use FinanceMCP is through the public service provided by the developers. No local installation or API keys are required.

Add the following configuration to your Claude Desktop configuration file:

{
  "mcpServers": {
    "finance-data-server": {
      "disabled": false,
      "timeout": 600,
      "type": "sse",
      "url": "http://106.14.205.176:3101/sse"
    }
  }
}

Configuration file location:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

After configuring, restart Claude Desktop to start using the service.

Local Installation

If you prefer to run the server locally, follow these steps:

Prerequisites

Node.js >= 18 - Download from nodejs.org
Tushare API Token - Register at tushare.pro

Getting a Tushare API Token

Register an account at tushare.pro/register
Retrieve your API Token from your personal center
Note that some advanced data requires points (credits)

Installation Methods

Method 1: Install via Smithery (Recommended)

npx -y @smithery/cli install @guangxiangdebizi/finance-mcp --client claude

Method 2: Manual Installation

# 1. Clone the repository
git clone https://github.com/guangxiangdebizi/FinanceMCP.git
cd FinanceMCP

# 2. Install dependencies
npm install

# 3. Configure API key
echo "TUSHARE_TOKEN=your_token_here" > .env
# Or directly edit the src/config.ts file

# 4. Build the project
npm run build

Starting the Server

Option 1: Direct Run (stdio mode)

node build/index.js

Option 2: Using Supergateway (Recommended for development)

npx supergateway --stdio "node build/index.js" --port 3100

Claude Configuration

Configuration 1: stdio mode

{
  "mcpServers": {
    "finance-data-server": {
      "command": "node",
      "args": ["C:/path/to/FinanceMCP/build/index.js"],
      "disabled": false,
      "autoApprove": [
        "current_timestamp",
        "finance_news",
        "stock_data",
        "index_data",
        "macro_econ",
        "company_performance",
        "fund_data",
        "fund_manager_by_name",
        "convertible_bond",
        "block_trade",
        "money_flow",
        "margin_trade"
      ]
    }
  }
}

Configuration 2: Supergateway mode (if using port 3100)

{
  "mcpServers": {
    "finance-data-server": {
      "url": "http://localhost:3100/sse",
      "type": "sse",
      "disabled": false,
      "timeout": 600,
      "autoApprove": [
        "current_timestamp",
        "finance_news",
        "stock_data",
        "index_data",
        "macro_econ",
        "company_performance",
        "fund_data",
        "fund_manager_by_name",
        "convertible_bond",
        "block_trade",
        "money_flow",
        "margin_trade"
      ]
    }
  }
}

Features and Tools

Supported Technical Indicators

MACD macd(12,26,9) - Trend analysis
RSI rsi(14) - Overbought/oversold conditions
KDJ kdj(9,3,3) - Stochastic indicator
BOLL boll(20,2) - Bollinger Bands
MA ma(5/10/20/60) - Moving Averages

Available Tools

current_timestamp - Current time in UTC+8 timezone
finance_news - Financial news search across 7+ media sources
stock_data - Stock data with technical indicators
index_data - Historical data for major market indices
macro_econ - Macroeconomic indicators (GDP, CPI, PPI, PMI, etc.)
company_performance - Company financial analysis
fund_data - Fund data (net value, holdings, dividends)
fund_manager_by_name - Fund manager information
convertible_bond - Convertible bond data
block_trade - Block trade information
money_flow - Capital flow analysis
margin_trade - Margin trading data

Example Queries

Stock Technical Analysis

"Analyze the technical status of Moutai (600519.SH), calculate MACD(12,26,9), RSI(14), KDJ(9,3,3)"
"Check CATL's (300750.SZ) Bollinger Bands BOLL(20,2) and four moving averages MA(5,10,20,60)"
"Apple Inc. (AAPL) stock price trend and MACD indicators for the past month"

Comprehensive Analysis

"Comprehensive analysis of BYD: financial condition, technical indicators, capital flow, latest news"
"Compare the performance and technical indicators of A-shares, US stocks, and Hong Kong markets"
"Evaluate CATL's investment value: fundamentals + technical + capital aspects"

News and Macroeconomics

"Search for the latest policies and market dynamics in the new energy vehicle sector"
"Analyze the current macroeconomic situation: GDP, CPI, PPI, PMI data"
"The impact of the Fed's interest rate hike on the Chinese stock market, relevant news and data"

Funds and Bonds

"Check the latest net value and portfolio structure of the CSI 300 ETF"
"Analyze the performance of funds managed by Zhang Kun"
"Overview and investment opportunities in the convertible bond market"

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "finance-data-server" '{"command":"node build/index.js","type":"stdio","disabled":false,"autoApprove":["current_timestamp","finance_news","stock_data","index_data","macro_econ","company_performance","fund_data","convertible_bond"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "finance-data-server": {
            "command": "node build/index.js",
            "type": "stdio",
            "disabled": false,
            "autoApprove": [
                "current_timestamp",
                "finance_news",
                "stock_data",
                "index_data",
                "macro_econ",
                "company_performance",
                "fund_data",
                "convertible_bond"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "finance-data-server": {
            "command": "node build/index.js",
            "type": "stdio",
            "disabled": false,
            "autoApprove": [
                "current_timestamp",
                "finance_news",
                "stock_data",
                "index_data",
                "macro_econ",
                "company_performance",
                "fund_data",
                "convertible_bond"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect