Stock Market MCP Server

by mcp-100

3 stars
476 downloads
Not rated
GitHub

About

Retrieves real-time financial market data from Alpha Vantage, enabling comprehensive stock analysis, investment research, and market intelligence through dynamic querying capabilities.

Details

Author
mcp-100
Repository
MCP-100/stock-market-server
GitHub stars
3
Downloads
476
Categories
Cloud Service, Finance, API, Other, AI, Design, Developer Tools, Search, Frontend, Infrastructure
Tags
#data-analysis

- Retrieve real-time stock ticker price and timestamp
- Fetch a US market overview report
- Get financial statements: income, balance sheet, cash flow
- Access company overview with key metrics and info

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Stock Market MCP Server
    Command (node, npx, python, etc.) node
    Arguments
    • Argument 1 /path/to/stock-market-server/build/index.js

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install dependencies with npm install, build with npm run build, and add the server configuration to your Claude Desktop configuration file (JSON) specifying the path to the built index.js. Obtain a free API key from Alpha Vantage and set it as an environment variable or directly in code.

get_ticker_price

获取股票实时价格. 需要提供股票代码作为参数. 返回最新的股票价格和时间戳.

get_market_report

获取美国市场报告. 提供市场整体状况概览.

get_financial_statement

获取公司财务报表. 支持三种报表类型:收入报表(income)、资产负债表(balance)、现金流量表(cashflow). 需要提供股票代码和报表类型.

get_company_overview

获取公司概览信息. 需要提供股票代码. 返回公司关键指标和基本信息.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "stock market mcp server": {
            "cwd": null,
            "env": {},
            "args": [
                "/path/to/stock-market-server/build/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Linux

{
    "cwd": null,
    "env": [],
    "args": [
        "/path/to/stock-market-server/build/index.js"
    ],
    "shell": false,
    "command": "node"
}

Macos

{
    "cwd": null,
    "env": [],
    "args": [
        "/path/to/stock-market-server/build/index.js"
    ],
    "shell": false,
    "command": "node"
}

Windows

{
    "cwd": null,
    "env": [],
    "args": [
        "/path/to/stock-market-server/build/index.js"
    ],
    "shell": false,
    "command": "node"
}

Stock Market MCP Server

一个基于 TypeScript 的 MCP 服务器,用于获取股票市场数据。该服务器通过 Alpha Vantage API 提供实时股票市场信息和公司财务数据。

生成该 MCPServer 的关键信息

- .clinerules - api-key
1.Plan mode

help me build a stock market mcp server that uses the AlphaVantage public API
I want it to have these tools:
- generate US market report/briefing
- generate financial statement for company
- get ticker price for company
- any other basic tools you think would be helpful
- api key: <you api key>

2. please test all the tools to confirm their functionality

功能特点

工具

- get_ticker_price - 获取股票实时价格 - 需要提供股票代码作为参数 - 返回最新的股票价格和时间戳

- get_market_report - 获取美国市场报告
- 提供市场整体状况概览

- get_financial_statement - 获取公司财务报表
- 支持三种报表类型:收入报表(income)、资产负债表(balance)、现金流量表(cashflow)
- 需要提供股票代码和报表类型

- get_company_overview - 获取公司概览信息
- 需要提供股票代码
- 返回公司关键指标和基本信息

开发环境配置

安装依赖

npm install

构建项目

npm run build

开发模式(自动重新构建)

npm run watch

安装说明

要在 Claude Desktop 中使用此服务器,需要添加服务器配置:

MacOS

配置文件路径:~/Library/Application Support/Claude/claude_desktop_config.json

Windows

配置文件路径:%APPDATA%/Claude/claude_desktop_config.json

配置示例:

{
"mcpServers": {
"stock-market-server": {
"command": "/path/to/stock-market-server/build/index.js"
}
}
}

调试

由于 MCP 服务器通过标准输入输出(stdio)通信,调试可能比较困难。推荐使用 MCP Inspector 工具进行调试:

npm run inspector

运行后,Inspector 将提供一个浏览器访问地址,可以通过浏览器使用调试工具。

技术栈

- TypeScript
- Node.js
- Alpha Vantage API
- MCP SDK (@modelcontextprotocol/sdk)

注意事项

- 使用前需要确保有有效的 Alpha Vantage API 密钥
- 所有 API 响应都以 JSON 格式返回
- 请注意 Alpha Vantage API 的调用频率限制

许可证

[添加许可证信息]

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.