https://github.com/xbluecode/findata-mcp-server
https://github.com/xbluecode/findata-mcp-server
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/xbluecode/findata-mcp-server
- Owner: xBlueCode
- Created: 2024-12-19T03:02:35.000Z (10 months ago)
- Default Branch: master
- Last Pushed: 2025-04-03T18:10:20.000Z (6 months ago)
- Last Synced: 2025-06-17T13:18:55.034Z (4 months ago)
- Language: JavaScript
- Size: 13.7 KB
- Stars: 7
- Watchers: 1
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Financial Data - MCP Server
[](https://smithery.ai/server/findata-mcp-server)
This is an MCP server that provides access to the Alpha Vantage API, allowing stock data retrieval to be used as context to LLMs.
## Available Features
* `getStockQuote`: Get the current quote for a stock.
* `getHistoricalData`: Get historical data for a stock (daily, weekly, or monthly).
* (More tools will be added later for technical analysis, company overview, etc.)
## Setup
### Installing via Smithery
To install Financial Data Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/findata-mcp-server):
```bash
npx -y @smithery/cli install findata-mcp-server --client claude
```
### Manual Installation
```bash
npm install findata-mcp-server
```
## Usage in Host
1. Obtain an API key from Alpha Vantage https://www.alphavantage.co/support/#api-key.
2. Configure your MCP client (e.g., Claude Desktop) to connect to the server:
```JSON
{
"mcpServers": {
"alphaVantage": {
"command": "npx",
"args": ["-y", "findata-mcp-server"],
"env": {
"ALPHA_VANTAGE_API_KEY": "PUT_YOUR_API_KEY_HERE"
}
}
}
}
```
## Tools
### `getStockQuote`
Get the current quote for a stock.
Input:
`symbol`: The stock symbol (e.g., AAPL)
Output Example:
### `getHistoricalData`
Get historical data for a stock.
Input:
- `symbol`: the stock symbol (e.g., AAPL)
- `interval`: the time interval for the data (`daily`, `weekly`, or `monthly`) (optional, default: `daily`)
- `outputsize`: the size of the output (`compact` or `full`) (optional, default: `compact`)
Output:
JSON object containing the historical data. The structure of the output depends on the interval parameter.
## Contributing
Contributions are welcome! Please open an issue or pull request.
### License
MIT