Portfolio Manager

Portfolio Manager MCP Server

A Model Context Protocol (MCP) server that provides tools and resources for managing and analyzing investment portfolios.

Features

Portfolio Management: Create and update investment portfolios with stocks and bonds
Market Data: Fetch real-time stock price information and relevant news
Analysis: Generate comprehensive portfolio reports and performance analysis
Recommendations: Get personalized investment recommendations based on portfolio composition
Visualization: Create visual representations of portfolio allocation

Installation

Clone this repository:
git clone https://github.com/ikhyunAn/portfolio-manager-mcp.git cd portfolio-manager-mcp
Install the required dependencies:
pip install -r requirements.txt
Set up API keys (optional):
export ALPHA_VANTAGE_API_KEY="your_key_here" export NEWS_API_KEY="your_key_here"
Alternatively, create a .env file in the root of the directory and store the API keys

Usage

Running the Server

You can run the server in two different modes:

Stdio Transport (default, for Claude Desktop integration):
python main.py # alternate commands: i.e.) python3, python3.11
SSE Transport (for HTTP-based clients):
python main.py --sse

Integration with Claude Desktop

Add the server to your Claude Desktop configuration file:

{
  "mcpServers": {
    "portfolio-manager": {
      "command": "python",      // may use different command
      "args": ["/path/to/portfolio-manager-mcp/main.py"],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "your_key_here",
        "NEWS_API_KEY": "your_key_here"
      }
    }
  }
}

If you choose to run your server in a virtual environment, then your configuration file will look like:

{
  "mcpServers": {
    "portfolio-manager": {
      "command": "/path/to/portfolio-manager-mcp/venv/bin/python",
      "args": ["/path/to/portfolio-manager-mcp/main.py"],
      "env": {
        "PYTHONPATH": "/path/to/portfolio-manager-mcp",
        "ALPHA_VANTAGE_API_KEY": "your_key_here",
        "NEWS_API_KEY": "your_key_here"
      }
    }
  }
}

To run it in a virtual environment:

# Create a virtual environment
python3 -m venv venv

# Activate the virtual environment
source venv/bin/activate  # On macOS/Linux
# or
# venv\Scripts\activate   # On Windows

# Install dependencies
pip install -r requirements.txt

# Run the server
python3 main.py

Or use the MCP CLI for easier installation:

mcp install main.py

Example Queries

Once the server is running and connected to Claude, you can interact with it using natural language:

"Create a portfolio with 30% AAPL, 20% MSFT, 15% AMZN, and 35% US Treasury bonds with user Id "
"What's the recent performance of my portfolio?"
"Show me news about the stocks in my portfolio"
"Generate investment recommendations for my current portfolio"
"Visualize my current asset allocation"

Project Structure

portfolio-manager/
├── main.py                      # Entry point
├── portfolio_server/            # Main package
│   ├── api/                     # External API clients
│   │   ├── alpha_vantage.py     # Stock market data API
│   │   └── news_api.py          # News API
│   ├── data/                    # Data management
│   │   ├── portfolio.py         # Portfolio models
│   │   └── storage.py           # Data persistence
│   ├── resources/               # MCP resources
│   │   └── portfolio_resources.py # Portfolio resource definitions
│   ├── tools/                   # MCP tools
│   │   ├── analysis_tools.py    # Portfolio analysis
│   │   ├── portfolio_tools.py   # Portfolio management
│   │   ├── stock_tools.py       # Stock data and news
│   │   └── visualization_tools.py # Visualization tools
│   └── server.py                # MCP server setup
└── requirements.txt             # Dependencies

Future Work

As of now, the MCP program uses manually created JSON file which keeps track of each user's investment portfolio.

This should be fixed so that it reads in the portfolio data from actual banking applications.

Tasks

Extract JSON from a Finance or Banking Application which the user uses
Enable modifying the investment portfolio by the client
Implement automated portfolio rebalancing
Add support for cryptocurrency assets
Develop mobile application integration

License

MIT

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables users to create, manage, and analyze investment portfolios with real-time market data, personalized recommendations, and visual representations of asset allocation.

Related MCP Servers

PolyMarket MCP Server
berlinbra
A
security
A
license
A
quality
Enables interaction with the PolyMarket API to fetch prediction market data such as market information, prices, and historical data, with robust error handling and rate limit management.
Last updated -
4
31
Python
MIT License
mcp-octagonofficial
OctagonAI
A
security
A
license
A
quality
Deliver real-time investment research with extensive private and public market data.
Last updated -
11
847
55
JavaScript
MIT License
Asset Price MCP Server
mk965
A
security
A
license
A
quality
A server that provides tools for retrieving real-time price information for various assets including precious metals and cryptocurrencies, allowing language models to access and display current asset price data.
Last updated -
1
261
2
JavaScript
MIT License
MCP Yahoo Finance
leoncuhk
A
security
F
license
A
quality
Provides tools to get financial data (stock prices, company information) and generate financial visualizations through the Model Context Protocol.
Last updated -
10
4
Python

View all related MCP servers

Portfolio Manager