株式市場データAPI、Alphavantage APIのMCPサーバー。

MCP サーバー URL: [https://mcp.alphavantage.co

PyPi: [https://pypi.org/project/alphavantage-mcp/]

設定

API キーの取得

1. 無料のAlphavantage APIキーに登録
2. 環境変数に API キーを [ALPHAVANTAGE_API_KEY に追加します。

インストール

Option 1: uvx の使用 (推奨)

AlphaVantage MCP サーバーを使用する最も簡単な方法は、[uvx] です。

##Option 2: pip の使用

##Option 3: ソースから

サーバーモード

AlphaVantage サーバは 2 つのモードで実行できます。

##Stdio Server (デフォルト) これは、Claude Desktopのようなツールに使用される標準のMCPサーバーモードです。

ストリーミング可能な HTTP サーバ

このモードは、HTTP ストリーミングでリアルタイムの更新を提供します。

##OAuth 2.1 認証で HTTP サーバをストリーミング可能 このモードは、セキュアなアクセスのために、MCP 仕様に従って、HTTP サーバに OAuth 2.1 認証を追加します。

####OAuth の設定

[--oauth フラグを使用する場合は、サーバーは環境変数を介して OAuth 2.1 の設定が必要です。

必須環境変数:

任意環境変数:

OAuthの特徴

OAuth の実装は:

✅ Official Alpha Vantage MCP Server

A MCP server for the stock market data API, Alphavantage API.

MCP Server URL: https://mcp.alphavantage.co

PyPi: https://pypi.org/project/alphavantage-mcp/

Configuration

Getting an API Key

1. Sign up for a Free Alphavantage API key
2. Add the API key to your environment variables as ALPHAVANTAGE_API_KEY

Installation

Option 1: Using uvx (Recommended)

The easiest way to use the AlphaVantage MCP server is with uvx:

# Run directly without installation
uvx alphavantage-mcp

# Or with specific arguments
uvx alphavantage-mcp --server http --port 8080

Option 2: Using pip

pip install alphavantage-mcp
alphavantage-mcp

Option 3: From source

git clone https://github.com/calvernaz/alphavantage.git
cd alphavantage
uv run alphavantage

Server Modes

The AlphaVantage server can run in two different modes:

Stdio Server (Default)

This is the standard MCP server mode used for tools like Claude Desktop.

alphavantage
# or explicitly:
alphavantage --server stdio

Streamable HTTP Server

This mode provides real-time updates via HTTP streaming.

alphavantage --server http --port 8080

Streamable HTTP Server with OAuth 2.1 Authentication

This mode adds OAuth 2.1 authentication to the HTTP server, following the MCP specification for secure access.

alphavantage --server http --port 8080 --oauth

OAuth Configuration

When using the --oauth flag, the server requires OAuth 2.1 configuration via environment variables:

Required Environment Variables:

export OAUTH_AUTHORIZATION_SERVER_URL="https://your-auth-server.com/realms/your-realm"
export OAUTH_RESOURCE_SERVER_URI="https://your-mcp-server.com"

Optional Environment Variables:

# Token validation method (default: jwt)
export OAUTH_TOKEN_VALIDATION_METHOD="jwt"  # or "introspection"

# For JWT validation
export OAUTH_JWT_PUBLIC_KEY="-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----"
export OAUTH_JWT_ALGORITHM="RS256"  # default

# For token introspection validation
export OAUTH_INTROSPECTION_ENDPOINT="https://your-auth-server.com/realms/your-realm/protocol/openid-connect/token/introspect"
export OAUTH_INTROSPECTION_CLIENT_ID="your-client-id"
export OAUTH_INTROSPECTION_CLIENT_SECRET="your-client-secret"

# Optional: Required scopes (space-separated)
export OAUTH_REQUIRED_SCOPES="mcp:access mcp:read"