주식 시장 데이터 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

설치

옵션 1: uvx 사용 (추천)

AlphaVantage MCP 서버를 사용하는 가장 쉬운 방법은 uvx와 같습니다.

옵션 2: pip 사용

선택권 3: 근원에서

서버 모드

AlphaVantage 서버는 두 가지 다른 모드에서 실행할 수 있습니다.

Stdio Server (기본값)

Claude Desktop과 같은 도구에 사용되는 표준 MCP 서버 모드입니다.

Streamable HTTP 서버

이 모드는 HTTP 스트리밍을 통해 실시간 업데이트를 제공합니다.

OAuth 2.1 Authentication을 가진 Streamable 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"