Okevinok
About
Okevinok is a Model Context Protocol (MCP) server that provides stock market data from the Alpha Vantage API. It enables Claude and other MCP clients to access real-time and historical stock data. The server requires Node.js 16 or higher and a free Alpha Vantage API key.
Details
- Author
- okevinok
- Downloads
- 198
- Categories
- Other
Jump to
- Retrieve intraday stock data with customizable intervals
- Obtain daily stock data for any symbol
- Generate stock alerts based on price movement thresholds
- Access stock data directly as MCP resources
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:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
OkevinokCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository, run npm install, add your Alpha Vantage API key to a .env file, then build with npm run build and start with npm start. For use with Claude for Desktop, add a configuration entry to claude_desktop_config.json specifying the command node with the path to the built index.js and the API key as an environment variable.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"okevinok": {
"mcp-akshare-hust": {
"command": "uvx",
"args": [
"mcp-akshare-hust"
]
}
}
}
}McpServers
{
"mcp-akshare-hust": {
"command": "uvx",
"args": [
"mcp-akshare-hust"
]
}
}Alpha Vantage Stock MCP Server
This is a Model Context Protocol (MCP) server that provides stock market data from Alpha Vantage API. It allows Claude and other MCP clients to access real-time and historical stock data.
<a href="https://glama.ai/mcp/servers/1ujui2kmxd">
</a>
Features
- Get intraday stock data with customizable intervals
- Get daily stock data
- Generate stock alerts based on price movements
- Access stock data as resources
Prerequisites
- Node.js 16 or higher
- An Alpha Vantage API key (get one for free at Alpha Vantage)
Installation
1. Clone this repository
2. Install dependencies:
npm install
3. Create a
.env file in the root directory and add your Alpha Vantage API key: ALPHA_VANTAGE_API_KEY=your_api_key_here
Building and Running
Build the TypeScript code:
npm run build
Run the server:
npm start
For development with auto-reloading:
npm run dev
Test the API client:
npm test
Using with Claude for Desktop
To use this MCP server with Claude for Desktop:
1. Open Claude for Desktop
2. Go to Settings > Developer > Edit Config
3. Add the following to your claude_desktop_config.json:
{
"mcpServers": {
"alpha-vantage": {
"command": "node",
"args": ["/absolute/path/to/dist/index.js"],
"env": {
"ALPHA_VANTAGE_API_KEY": "YOUR_API_KEY"
}
}
}
}
Replace /absolute/path/to/dist/index.js with the absolute path to the built index.js file.
4. Restart Claude for Desktop
Available Tools
get-stock-data
Gets intraday stock data for a specific symbol.
Parameters:
- symbol (required): Stock symbol (e.g., IBM, AAPL)
- interval (optional): Time interval between data points (1min, 5min, 15min, 30min, 60min). Default: 5min
- outputsize (optional): Amount of data to return (compact: latest 100 data points, full: up to 20 years of data). Default: compact
get-daily-stock-data
Gets daily stock data for a specific symbol.
Parameters:
- symbol (required): Stock symbol (e.g., IBM, AAPL)
- outputsize (optional): Amount of data to return (compact: latest 100 data points, full: up to 20 years of data). Default: compact
get-stock-alerts
Analyzes stock data to generate alerts based on price movements.
Parameters:
- symbol (required): Stock symbol (e.g., IBM, AAPL)
- threshold (optional): Percentage threshold for price movement alerts. Default: 5
Available Resources
stock-data
Access stock data directly as a resource.
URI Template: stock://{symbol}/{interval}
Parameters:
- symbol: Stock symbol (e.g., IBM, AAPL)
- interval: Time interval (daily, 1min, 5min, 15min, 30min, 60min). Default: daily
Example usage in Claude:
- "Can you analyze this stock data: stock://AAPL/daily"
- "What do you think about this data: stock://MSFT/5min"
License
MIT
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
