股票MCP服务器
一个模型上下文协议（MCP）服务器，通过免费方式提供实时金融市场数据访问 Alpha Vantage API此服务器实现了用于获取股票报价和公司信息的标准化接口。
特点/功能
- 实时股票报价，包含价格、成交量和涨跌幅数据
- 详细的公司信息，包括行业领域、所属行业及市值
- 实时加密货币汇率，含买/卖价
- 每日、每周和每月的加密货币时间序列数据
- 带有高级过滤和排序功能的历史期权链数据
- 内置错误处理和速率限制管理
安装
使用Claude桌面版
- 克隆仓库并构建本地镜像以供您的Claude桌面客户端使用
- 改变你的
claude_desktop_config.json以匹配以下内容，替换为REPLACE_API_KEY使用您实际的密钥：
claude_desktop_config.json路径 - 在MacOS上：~/Library/Application\ Support/Claude/claude_desktop_config.json- 在Windows上：%APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"alphavantage": {
"command": "python",
"args": [
"-m",
"alpha_vantage_mcp.server",
"run",
"server.py"
],
"env": {
"ALPHA_VANTAGE_API_KEY": "insert_your_alpha_api_key",
"PYTHONPATH": "Path to the server.py"
}
}
}
}安装软件包
uv add -r requiremets.txt .跑步
在通过JSON文件将Claude客户端与MCP工具连接并安装包之后，Claude应该能够看到服务器的MCP工具：
你可以通过以下方式自行运行服务器： 在 alpha-vantage-mcp 仓库中：
uv run src/alpha_vantage_mcp/server.py可用工具
服务器实现了八种工具：
get-stock-quote获取特定公司的最新股票报价get-company-info获取特定公司的股票相关信息get-time-series获取某股票的历史每日价格数据get-historical-options获取具有排序功能的历史期权链数据get-crypto-exchange-rate获取当前加密货币汇率get-crypto-daily获取加密货币的每日时间序列数据get-crypto-weekly获取加密货币的周时间序列数据get-crypto-monthly获取加密货币的月度时间序列数据
获取股票报价
输入模式（或输入架构）：
{
"symbol": {
"type": "string",
"description": "Stock symbol (e.g., AAPL, MSFT)"
}
}示例回复：
Stock quote for AAPL:
Price: $198.50
Change: $2.50 (+1.25%)
Volume: 58942301
High: $199.62
Low: $197.20获取公司信息
检索给定符号的详细公司信息。
输入模式：
{
"symbol": {
"type": "string",
"description": "Stock symbol (e.g., AAPL, MSFT)"
}
}示例回复：
Company information for AAPL:
Name: Apple Inc
Sector: Technology
Industry: Consumer Electronics
Market Cap: $3000000000000
Description: Apple Inc. designs, manufactures, and markets smartphones...
Exchange: NASDAQ
Currency: USD获取加密货币汇率
获取实时加密货币汇率及附加市场数据。
输入模式：
{
"crypto_symbol": {
"type": "string",
"description": "Cryptocurrency symbol (e.g., BTC, ETH)"
},
"market": {
"type": "string",
"description": "Market currency (e.g., USD, EUR)",
"default": "USD"
}
}示例回复：
Cryptocurrency exchange rate for BTC/USD:
From: Bitcoin (BTC)
To: United States Dollar (USD)
Exchange Rate: 43521.45000
Last Updated: 2024-12-17 19:45:00 UTC
Bid Price: 43521.00000
Ask Price: 43522.00000获取时间序列
获取每日时间序列（开盘价、最高价、最低价、收盘价、成交量）数据。
输入模式（或输入架构）：
{
"symbol": {
"type": "string",
"description": "Stock symbol (e.g., AAPL, MSFT)"
},
"outputsize": {
"type": "string",
"description": "compact (latest 100 data points) or full (up to 20 years of data)",
"default": "compact"
}
}示例回复：
Time Series Data for AAPL (Last Refreshed: 2024-12-17 16:00:00):
Date: 2024-12-16
Open: $195.09
High: $197.68
Low: $194.83
Close: $197.57
Volume: 55,751,011获取历史期权数据
检索历史期权链数据，具备高级排序和过滤功能。
输入模式（或输入模式定义）：
{
"symbol": {
"type": "string",
"description": "Stock symbol (e.g., AAPL, MSFT)"
},
"date": {
"type": "string",
"description": "Optional: Trading date in YYYY-MM-DD format (defaults to previous trading day, must be after 2008-01-01)",
"pattern": "^20[0-9]{2}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])$"
},
"limit": {
"type": "integer",
"description": "Optional: Number of contracts to return (default: 10, use -1 for all contracts)",
"default": 10,
"minimum": -1
},
"sort_by": {
"type": "string",
"description": "Optional: Field to sort by",
"enum": ["strike", "expiration", "volume", "open_interest", "implied_volatility", "delta", "gamma", "theta", "vega", "rho", "last", "bid", "ask"],
"default": "strike"
},
"sort_order": {
"type": "string",
"description": "Optional: Sort order",
"enum": ["asc", "desc"],
"default": "asc"
}
}示例回复：
Historical Options Data for AAPL (2024-02-20):
Contract 1:
Strike: $190.00
Expiration: 2024-03-15
Last: $8.45
Bid: $8.40
Ask: $8.50
Volume: 1245
Open Interest: 4567
Implied Volatility: 0.25
Greeks:
Delta: 0.65
Gamma: 0.04
Theta: -0.15
Vega: 0.30
Rho: 0.25
Contract 2:
...获取加密货币每日资讯
获取加密货币的每日时间序列数据。
输入模式（或输入架构）：
{
"symbol": {
"type": "string",
"description": "Cryptocurrency symbol (e.g., BTC, ETH)"
},
"market": {
"type": "string",
"description": "Market currency (e.g., USD, EUR)",
"default": "USD"
}
}示例回复：
Daily cryptocurrency time series for SOL in USD:
Daily Time Series for Solana (SOL)
Market: United States Dollar (USD)
Last Refreshed: 2025-04-17 00:00:00 UTC
Date: 2025-04-17
Open: 131.31000000 USD
High: 131.67000000 USD
Low: 130.74000000 USD
Close: 131.15000000 USD
Volume: 39652.22195178
---
Date: 2025-04-16
Open: 126.10000000 USD
High: 133.91000000 USD
Low: 123.46000000 USD
Close: 131.32000000 USD
Volume: 1764240.04195810
---获取加密货币周报
获取加密货币的每周时间序列数据。
输入模式（或输入架构）：
{
"symbol": {
"type": "string",
"description": "Cryptocurrency symbol (e.g., BTC, ETH)"
},
"market": {
"type": "string",
"description": "Market currency (e.g., USD, EUR)",
"default": "USD"
}
}示例回复：
Weekly cryptocurrency time series for SOL in USD:
Weekly Time Series for Solana (SOL)
Market: United States Dollar (USD)
Last Refreshed: 2025-04-17 00:00:00 UTC
Date: 2025-04-17
Open: 128.32000000 USD
High: 136.00000000 USD
Low: 123.46000000 USD
Close: 131.15000000 USD
Volume: 4823091.05667581
---
Date: 2025-04-13
Open: 105.81000000 USD
High: 134.11000000 USD
Low: 95.16000000 USD
Close: 128.32000000 USD
Volume: 18015328.38860037
---获取加密货币月度数据
获取加密货币的月度时间序列数据。
输入模式：
{
"symbol": {
"type": "string",
"description": "Cryptocurrency symbol (e.g., BTC, ETH)"
},
"market": {
"type": "string",
"description": "Market currency (e.g., USD, EUR)",
"default": "USD"
}
}示例回复：
Monthly cryptocurrency time series for SOL in USD:
Monthly Time Series for Solana (SOL)
Market: United States Dollar (USD)
Last Refreshed: 2025-04-17 00:00:00 UTC
Date: 2025-04-17
Open: 124.51000000 USD
High: 136.18000000 USD
Low: 95.16000000 USD
Close: 131.15000000 USD
Volume: 34268628.85976021
---
Date: 2025-03-31
Open: 148.09000000 USD
High: 180.00000000 USD
Low: 112.00000000 USD
Close: 124.54000000 USD
Volume: 42360395.75443056
---要求；需求
- Python 3.12 或更高版本
- httpx
- mcp（多种含义，常见如“最小化兼容产品”、“微控制器协议”等，具体需根据上下文确定）