finmap-org/mcp-server

分类File System
作者Community
星标350
定价Free

简介

finmap-org/mcp-server 是一款面向金融分析场景的 MCP 插件，它将美、英、俄、土四大市场的历史股市数据直接接入 AI 助手。开发者无需手动导出 CSV 或编写复杂的 API 调用代码，即可通过自然语言让 AI 查询公司概况、市值、成交量等核心指标。该工具不仅提供结构化数据，还支持生成树图和直方图等可视化分析，极大地降低了量化分析和市场调研的门槛，让 AI 真正具备实时检索全球多市场金融数据的能力。

核心亮点

  • 覆盖美英俄土四大市场，实时获取个股核心指标
  • 支持树图与直方图，将金融数据直观可视化
  • 无需编写 API 代码，通过自然语言即可分析股市
  • 打通 AI 与金融数据库，提升量化调研效率

完整文档

Finmap MCP Server

finmap.org MCP server 提供来自美国、英国、俄罗斯和土耳其证券交易所的全面历史数据。可访问 sectors、tickers、公司概况、market cap、volume、value 和 trade counts，以及 treemap 和 histogram 可视化图表。

支持的交易所

| 交易所 | Code | 国家 | 最早数据 | 更新频率 |
|----------|------|---------|---------------|------------------|
| New York Stock Exchange | nyse | 美国 | 2024-12-09 | 每日 |
| NASDAQ Stock Market | nasdaq | 美国 | 2024-12-09 | 每日 |
| American Stock Exchange | amex | 美国 | 2024-12-09 | 每日 |
| US Combined (AMEX + NASDAQ + NYSE) | us-all | 美国 | 2024-12-09 | 每日 |
| London Stock Exchange | lse | 英国 | 2025-02-07 | 每小时（工作日） |
| Hong Kong Stock Exchange | hkex | 香港 | 2025-09-29 | 每 30 分钟（工作日） |
| Borsa Istanbul | bist | 土耳其 | 2015-11-30 | 每两个月 |
| Moscow Exchange | moex | 俄罗斯 | 2011-12-19 | 每 15 分钟（工作日） |

安装与使用

选项 1：远程服务器（托管）

无需安装即可连接到我们的托管 MCP server：

Server URL: https://mcp.finmap.org

Claude Desktop 配置:

json
{
  "mcpServers": {
    "finmap": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.finmap.org"]
    }
  }
}
### 选项 2：本地包 (npm)

在本地安装并运行，以获得更好的性能和离线访问：

bash
# Install globally
npm install -g finmap-mcp


Or use directly

npx finmap-mcp
Claude Desktop 配置：
json
{
  "mcpServers": {
    "finmap": {
      "command": "npx",
      "args": ["-y", "finmap-mcp"]
    }
  }
}
## HTTP API Wrapper

服务器还提供了一个精简的 HTTP API，用于 GPT Actions 和直接集成。

  • GET /api/openapi.json
  • GET /api/list-exchanges
  • POST /api/list-sectors
  • POST /api/list-sector-companies
  • POST /api/search-companies
  • POST /api/market-overview
  • POST /api/sector-performance
  • POST /api/rank-stocks
  • POST /api/stock-snapshot
  • POST /api/company-profile

可直接导入的 GPT Actions schema 位于 gpt-actions.yaml 中。

Available Tools

1. list_supported_exchanges

- Title: 列出支持的证券交易所 - Description: 返回 Finmap 数据集中所有支持的证券交易所的元数据。包括交易所 ID、交易所名称、国家、货币、最早可用历史数据日期以及更新频率。

Example Prompt: #finmap-mcp list available stock exchanges

Example Response:

json
{
    "exchanges": [
      {
        "id": "amex",
        "name": "American Stock Exchange",
        "country": "United States",
        "currency": "USD",
        "availableSince": "2024-12-09",
        "updateFrequency": "Daily"
      },
      {
        "id": "nasdaq",
        "name": "NASDAQ Stock Market",
        "country": "United States",
        "currency": "USD",
        "availableSince": "2024-12-09",
        "updateFrequency": "Daily"
      },
      {
        "id": "nyse",
        "name": "New York Stock Exchange",
        "country": "United States",
        "currency": "USD",
        "availableSince": "2024-12-09",
        "updateFrequency": "Daily"
      },
      {
        "id": "us-all",
        "name": "US Combined (AMEX + NASDAQ + NYSE)",
        "country": "United States",
        "currency": "USD",
        "availableSince": "2024-12-09",
        "updateFrequency": "Daily"
      },
      {
        "id": "lse",
        "name": "London Stock Exchange",
        "country": "United Kingdom",
        "currency": "GBP",
        "availableSince": "2025-02-07",
        "updateFrequency": "Hourly (weekdays)"
      },
      {
        "id": "moex",
        "name": "Moscow Exchange",
        "country": "Russia",
        "currency": "RUB",
        "availableSince": "2011-12-19",
        "updateFrequency": "Every 15 minutes (weekdays)"
      },
      {
        "id": "bist",
        "name": "Borsa Istanbul",
        "country": "Turkey",
        "currency": "TRY",
        "availableSince": "2015-11-30",
        "updateFrequency": "Every two months"
      },
      {
        "id": "hkex",
        "name": "Hong Kong Stock Exchange",
        "country": "Hong Kong",
        "currency": "HKD",
        "availableSince": "2025-09-29",
        "updateFrequency": "Every 30 minutes (weekdays)"
      }
    ]
  }
### 2. list_exchange_sectors
- 标题：列出证券交易所的板块
- 描述：返回特定交易所和交易日的所有可用业务板块。每个板块包含该板块中的公司数量。

示例 Prompt： #finmap-mcp List sectors for the Turkish stock exchange

示例 Response：

json
{
    "date": "2024-08-28",
    "exchange": "BIST",
    "currency": "TRY",
    "sectors": [
      {
        "name": "Finance",
        "itemsPerSector": 164
      },
      {
        "name": "MSPOTECW",
        "itemsPerSector": 4669
      },
      {
        "name": "MSPOTEPW",
        "itemsPerSector": 3335
      },
      {
        "name": "Industrials",
        "itemsPerSector": 277
      },
      {
        "name": "MSPOTXCR",
        "itemsPerSector": 2
      },
      {
        "name": "Real Estate",
        "itemsPerSector": 4
      },
      {
        "name": "Agriculture",
        "itemsPerSector": 5
      },
      {
        "name": "Utilities",
        "itemsPerSector": 32
      },
      {
        "name": "MSPOTGMF",
        "itemsPerSector": 9
      },
      {
        "name": "Technology",
        "itemsPerSector": 39
      },
      {
        "name": "Basic Materials",
        "itemsPerSector": 7
      },
      {
        "name": "MSPOTEMS",
        "itemsPerSector": 1
      },
      {
        "name": "MSPOTETF",
        "itemsPerSector": 21
      },
      {
        "name": "MSPOTGSF",
        "itemsPerSector": 8
      },
      {
        "name": "Consumer Staples",
        "itemsPerSector": 27
      },
      {
        "name": "Consumer Discretionary",
        "itemsPerSector": 14
      },
      {
        "name": "Health Care",
        "itemsPerSector": 9
      },
      {
        "name": "Miscellaneous",
        "itemsPerSector": 13
      },
      {
        "name": "Telecommunications",
        "itemsPerSector": 7
      },
      {
        "name": "MSPOTEQT",
        "itemsPerSector": 4
      }
    ]
  }
### 3. list_sector_companies
- Title: 按板块列出公司
- Description: 返回指定交易日期在某个交易所中按板块分组的公司 ticker 和名称。可选通过单个板块过滤结果。

Example Prompt: #finmap-mcp List companies in the Real Estate sector

Example Response:

json
{
    "date": "2024-08-28",
    "exchange": "BIST",
    "currency": "TRY",
    "sectors": {
      "Real Estate": [
        {
          "ticker": "ADESE.E",
          "name": "ADESE GAYRIMENKUL"
        },
        {
          "ticker": "IHLGM.E",
          "name": "IHLAS GAYRIMENKUL"
        },
        {
          "ticker": "RGYAS.E",
          "name": "RONESANS GAYRIMENKUL YAT."
        },
        {
          "ticker": "SONME.E",
          "name": "SONMEZ FILAMENT"
        }
      ]
    }
  }
### 4. search_exchange_companies
- 标题：通过名称或代码搜索公司
- 描述：通过部分代码或公司名称在特定交易所搜索公司。结果根据代码和名称的相似度按相关性排序。

示例 Prompt： #finmap-mcp Search for companies named 'Sprouts'

示例 Response：

json
{
    "date": "2025-08-28",
    "exchange": "NASDAQ",
    "currency": "USD",
    "query": "Sprouts",
    "matches": [
      {
        "ticker": "SFM",
        "name": "Sprouts Farmers Market Inc. Common Stock",
        "sector": "Consumer Staples",
        "score": 70
      }
    ]
  }
### 5. analyze_market_overview
- Title: 分析市场概览
- Description: 返回特定日期股票交易所的汇总统计数据。包括总市值、成交量、总成交额、成交笔数以及行业层面的市场分布。

Example Prompt: #finmap-mcp market overview for Nasdaq

Example Response:

json
{
    "date": "2025-08-28",
    "exchange": "NASDAQ",
    "currency": "USD",
    "marketTotal": {
      "name": "Market",
      "marketCap": 41238186996017,
      "marketCapChangePct": 0.6213636439596683,
      "volume": 7606048313,
      "value": 0,
      "numTrades": 0,
      "itemsPerSector": 7974
    },
    "sectors": [
      {
        "name": "Basic Materials",
        "marketCap": 248122454077,
        "marketCapChangePct": -0.19965738920998274,
        "volume": 40489423,
        "value": 0,
        "numTrades": 0,
        "itemsPerSector": 36
      },
      {
        "name": "Consumer Discretionary",
        "marketCap": 5313249666194,
        "marketCapChangePct": 0.5556221951442668,
        "volume": 1029152348,
        "value": 0,
        "numTrades": 0,
        "itemsPerSector": 580
      },
      {
        "name": "ETFS",
        "marketCap": 0,
        "marketCapChangePct": null,
        "volume": 0,
        "value": 0,
        "numTrades": 0,
        "itemsPerSector": 3976
      },
      ...
      {
        "name": "Utilities",
        "marketCap": 333109407104,
        "marketCapChangePct": -0.1881153782118469,
        "volume": 39232326,
        "value": 0,
        "numTrades": 0,
        "itemsPerSector": 48
      }
    ]
  }
### 6. analyze_sector_performance
- Title: 分析板块表现
- Description: 返回证券交易所中每个板块的聚合指标。包括板块市值、价格涨跌幅、成交量、成交额、成交笔数以及该板块的公司数量。

Example Prompt: #finmap-mcp Get overview for the Utilities sector

Example Response:

json
{
    "date": "2025-08-28",
    "exchange": "NASDAQ",
    "currency": "USD",
    "sectors": [
      {
        "name": "Utilities",
        "marketCap": 333109407104,
        "marketCapChangePct": -0.1881153782118469,
        "volume": 39232326,
        "value": 0,
        "numTrades": 0,
        "itemsPerSector": 48
      }
    ]
  }
### 7. get_stock_snapshot
- Title: 获取股市快照
- Description: 返回特定交易所和交易日期的单个股票代码的详细交易指标。包括开盘价、最后成交价、价格涨跌幅、成交量、成交额、成交笔数和市值。

Example Prompt: #finmap-mcp Dominion Energy, stock data

Example Response:

json
{
    "exchange": "nyse",
    "country": "United States",
    "currency": "USD",
    "sector": "Utilities",
    "ticker": "D",
    "nameEng": "Dominion Energy Inc. Common Stock",
    "nameOriginal": "",
    "priceOpen": 60.34,
    "priceLastSale": 59.81,
    "priceChangePct": -0.878,
    "volume": 3771759,
    "value": 0,
    "numTrades": 0,
    "marketCap": 51043865111,
    "listedFrom": "",
    "listedTill": ""
  }
### 8. rank_exchange_companies
- 标题：按市场指标对公司进行排名
- 描述：返回在特定交易所中按所选市场指标排名的公司。支持的排名指标：市值、价格涨跌幅、成交量、成交额和成交笔数。结果可以限制数量，并可选择按板块过滤。

示例 Prompt： #finmap-mcp UK, rank stocks by market cap

示例 Response：

json
{
    "date": "2025-08-28",
    "exchange": "LSE",
    "currency": "GBP",
    "sortBy": "marketCap",
    "order": "desc",
    "limit": 5,
    "count": 5,
    "stocks": [
      {
        "ticker": "AZN",
        "name": "ASTRAZENECA PLC ORD SHS $0.25",
        "sector": "Health Care",
        "priceLastSale": 11810,
        "priceChangePct": -0.5557426743011115,
        "marketCap": 184159063201,
        "volume": 0,
        "value": 0,
        "numTrades": 0
      },
      {
        "ticker": "HSBA",
        "name": "HSBC HLDGS PLC ORD $0.50 (UK REG)",
        "sector": "Finance",
        "priceLastSale": 955.8,
        "priceChangePct": 0.1676797317124293,
        "marketCap": 165599631829,
        "volume": 0,
        "value": 0,
        "numTrades": 0
      },
      {
        "ticker": "SHEL",
        "name": "SHELL PLC ORD EUR0.07",
        "sector": "Energy",
        "priceLastSale": 2715.5,
        "priceChangePct": 0,
        "marketCap": 158779785181,
        "volume": 0,
        "value": 0,
        "numTrades": 0
      },
      {
        "ticker": "ULVR",
        "name": "UNILEVER PLC ORD 3 1/9P",
        "sector": "Consumer Staples",
        "priceLastSale": 4610,
        "priceChangePct": -0.2812026822409691,
        "marketCap": 113348756395,
        "volume": 0,
        "value": 0,
        "numTrades": 0
      },
      {
        "ticker": "BHP",
        "name": "BHP GROUP LIMITED ORD NPV (DI)",
        "sector": "Basic Materials",
        "priceLastSale": 2073,
        "priceChangePct": 0.6310679611650485,
        "marketCap": 104611160052,
        "volume": 0,
        "value": 0,
        "numTrades": 0
      }
    ]
  }
### 9. get_company_profile_us
- Title: 获取美国公司概况
- Description: 返回美国上市公司的业务描述和背景信息。支持的交易所：NASDAQ、NYSE 和 AMEX。

Example Prompt: #finmap-mcp Sprouts Farmers Market, get company profile

Example Response:

json
{
    "data": {
      "ModuleTitle": {
        "label": "Module Title",
        "value": "Company Description"
      },
      "CompanyName": {
        "label": "Company Name",
        "value": "Sprouts Farmers Market, Inc."
      },
      "Symbol": {
        "label": "Symbol",
        "value": "SFM"
      },
      "Address": {
        "label": "Address",
        "value": "5455 EAST HIGH STREET,SUITE 111, PHOENIX, Arizona, 85054, United States"
      },
      "Phone": {
        "label": "Phone",
        "value": "+1 480 814-8016"
      },
      "Industry": {
        "label": "Industry",
        "value": "Food Chains"
      },
      "Sector": {
        "label": "Sector",
        "value": "Consumer Staples"
      },
      "Region": {
        "label": "Region",
        "value": "North America"
      },
      "CompanyDescription": {
        "label": "Company Description",
        "value": "Sprouts Farmers Market is an American specialty grocer offering an assortment highlighting fresh and naturally derived products. Its offerings   are especially focused on produce, which constituted around 21% of sales in fiscal 2021. Founded in 2002, the chain is most heavily concentrated in   California, which accounted for over one third of its 374 stores as of the end of fiscal 2021. All of the company's operations are in the United States,   with its stores largely located in the southern half of the country. The firm sells roughly 20,000 products (of which around 70% are attribute driven,   such as organic, plant-based, or catering to the keto or paleo diet), with private-label products accounting for about 16% of sales in fiscal 2021.   Perishable items accounted for 58% of fiscal 2021 sales."
      },
      "CompanyUrl": {
        "label": "Company Url",
        "value": "https://www.sprouts.com"
      },
      "KeyExecutives": {
        "label": "Key Executives",
        "value": [
          {
            "name": "Jack Loudon Sinclair",
            "title": "Chief Executive Officer & Director"
          },
          {
            "name": "James Bahrenburg",
            "title": "Chief Technology Officer"
          },
          {
            "name": "Nicholas Konat",
            "title": "President & Chief Operating Officer"
          }
        ]
      }
    },
    "message": null,
    "status": {
      "rCode": 200,
      "bCodeMessage": null,
      "developerMessage": null
    }
  }
## 数据提供方

数据源自 finmap.org —— 一个用于金融市场可视化与分析的交互式平台。

  • Website: https://finmap.org
  • GitHub: https://github.com/finmap-org
查看官方来源