pulse-mcp-server

rickyb30/pulse-mcp-server

3.3

If you are the rightful owner of pulse-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Pulse is a comprehensive Model Context Protocol (MCP) server built with FastMCP 2.0, offering a range of data analysis and monitoring capabilities.

Tools
4
Resources
0
Prompts
0

Pulse šŸ”āš”

Python 3.11+ FastMCP License: MIT Build Status Release GitHub release

A comprehensive Model Context Protocol (MCP) server built with FastMCP 2.0 that provides weather data, web search, calculations, AWS cost analysis, stock market analysis, and Snowflake cost monitoring capabilities.

šŸŒŸ Features

Core Tools

  • šŸ§® Calculator: Statistical operations (sum, average, min, max)
  • šŸŒ¤ļø Weather Data: Real-time weather information using OpenWeather API
  • šŸ” Web Search: DuckDuckGo search with OpenAI fallback
  • šŸ¦ AWS Cost Analysis: Multi-account AWS cost monitoring and optimization
  • šŸ“ˆ Stock Market Analysis: Real-time prices, technical indicators, portfolio tracking
  • ā„ļø Snowflake Cost Monitoring: Warehouse costs, credit usage, storage analysis

AWS Cost Analysis Features

  • šŸ“Š Profile Discovery: Automatically discovers AWS profiles from ~/.aws/config and ~/.aws/credentials
  • šŸ’° Cost Analysis: Analyzes running costs across multiple AWS accounts
  • šŸ“ˆ Top 5 Services: Identifies the most expensive AWS services by cost
  • šŸ“‹ Detailed Reports: Comprehensive cost breakdowns with percentages
  • šŸŽÆ Multi-Account Support: Aggregates costs across all configured AWS profiles

Stock Market Analysis Features

  • šŸ“Š Real-time Data: Current prices, changes, volume for any stock
  • šŸ” Technical Analysis: RSI, MACD, moving averages, Bollinger Bands
  • šŸ’¼ Portfolio Tracking: Performance analysis, gains/losses, allocations
  • šŸŽÆ Stock Screening: Filter stocks by P/E ratio, market cap, price ranges
  • šŸ’° Crypto Support: Bitcoin, Ethereum, and major cryptocurrencies
  • šŸ“ˆ Market Indices: S&P 500, NASDAQ, Dow Jones, VIX tracking

Snowflake Cost Analysis Features

  • šŸ” SSO Authentication: External browser authentication for company SSO
  • šŸ’° Overall Cost Monitoring: Compute and storage cost breakdown
  • šŸ­ Warehouse Analysis: Top 5 warehouses by cost and credit usage
  • šŸ“Š Credit Usage Tracking: Detailed credit consumption analysis
  • šŸ’¾ Storage Cost Analysis: Data, stage, and failsafe storage costs

Resources & Prompts

  • Server Status: Real-time server information
  • Configuration: Server settings and capabilities
  • AWS Profiles: Discovered AWS profile information
  • Market Overview: Current market indices and crypto prices
  • Analysis Templates: Pre-built prompts for AWS, stock, and Snowflake analysis

šŸš€ Quick Start

Prerequisites

  • Python 3.11+
  • Virtual environment
  • AWS CLI configured (for AWS cost analysis)
  • API Keys (optional):
    • OpenWeather API key
    • OpenAI API key

Installation

  1. Clone and Setup:
git clone https://github.com/yourusername/pulse-mcp-server.git
cd pulse-mcp-server
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt
  1. Configure Environment (optional):
python setup_env.py
  1. Configure AWS (for cost analysis):
aws configure  # Follow prompts to set up your AWS credentials

šŸ”§ Usage

Option 1: HTTP Server (Standalone)

# Start HTTP server on localhost:8000
python run_http_server.py

Option 2: Claude Desktop Integration

  1. Copy configuration from claude_config.json to:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. Update paths in the configuration file

  3. Restart Claude Desktop

  4. Look for the tools icon (šŸ”Ø)

Option 3: VSCode Integration

  1. Built-in MCP Support: Enable chat.mcp.enabled in VSCode settings
  2. Open the project in VSCode (.vscode/mcp.json is pre-configured)
  3. Use Chat view (Ctrl+Alt+I) in Agent mode
  4. Alternative: Install Cline extension for additional MCP features

šŸ“–

šŸ¦ AWS Cost Analysis

Available AWS Tools

1. Discover AWS Profiles
discover_aws_profiles()
  • Scans ~/.aws/config and ~/.aws/credentials
  • Returns all configured AWS profiles
  • Shows profile details and credentials status
2. Analyze AWS Costs
analyze_aws_costs(days=30, profile=None)
  • days: Number of days to analyze (default: 30)
  • profile: Specific profile to analyze (if None, analyzes all)
  • Returns detailed cost breakdown by service
  • Identifies top 5 most expensive services
3. Get Cost Report
get_aws_cost_report(days=30, format_type="detailed")
  • format_type: "detailed" or "summary"
  • Returns formatted text report
  • Includes cost optimization insights

Example Usage with Claude Desktop

Try these commands in Claude Desktop:

AWS Cost Analysis:

  • "Analyze my AWS costs for the last 30 days"
  • "Show me the top 5 most expensive AWS services"
  • "Generate a cost report for my AWS accounts"
  • "Which AWS profile is costing me the most?"

Stock Market Analysis:

  • "Get Apple stock information and technical analysis"
  • "Show me the current market indices"
  • "Analyze my portfolio with AAPL 100 shares at $150 cost basis"
  • "Screen stocks with P/E ratio under 25"
  • "What's Bitcoin's current price?"

Snowflake Cost Analysis:

  • "Connect to Snowflake using SSO with account xyz123 and user john.doe"
  • "Show me overall Snowflake costs for the last 30 days"
  • "Which are my top 5 most expensive warehouses?"
  • "Generate a Snowflake cost report"

Other Tools:

  • "What's the weather in Tokyo?"
  • "Calculate the average of 10, 20, 30, 40, 50"
  • "Search for information about Python programming"

šŸ“Š Sample AWS Cost Report

šŸ¦ AWS COST ANALYSIS REPORT
==================================================
šŸ“… Analysis Date: 2025-06-19T21:47:50
šŸ“Š Period: Last 30 days
šŸ‘„ Total Profiles: 2
āœ… Successful: 2
āŒ Failed: 0
šŸ’° Total Cost (All Accounts): $127.45

šŸŒŸ TOP 5 SERVICES (ALL ACCOUNTS)
----------------------------------------
1. Amazon EC2
   šŸ’° $89.32 (70.1%)
2. Amazon RDS
   šŸ’° $23.45 (18.4%)
3. Amazon S3
   šŸ’° $8.92 (7.0%)
4. Amazon CloudWatch
   šŸ’° $3.21 (2.5%)
5. AWS Lambda
   šŸ’° $2.55 (2.0%)

šŸ’ø MOST EXPENSIVE ACCOUNT
------------------------------
Profile: production
Account ID: 123456789012
Cost: $98.76

šŸ› ļø Configuration

Environment Variables

# API Keys (optional)
OPENWEATHER_API_KEY=your_openweather_key
OPENAI_API_KEY=your_openai_key

# Server Configuration
MCP_TRANSPORT=stdio  # or http
MCP_HOST=localhost
MCP_PORT=8000

AWS Configuration

The server automatically discovers AWS profiles from:

  • ~/.aws/config - AWS configuration file
  • ~/.aws/credentials - AWS credentials file

Ensure your AWS credentials have the following permissions:

  • ce:GetCostAndUsage (Cost Explorer)
  • sts:GetCallerIdentity (Account information)

šŸ“ Project Structure

pulse-mcp-server/
ā”œā”€ā”€ .gitignore                  # Git ignore rules
ā”œā”€ā”€ .vscode/                    # VSCode configuration
ā”‚   ā”œā”€ā”€ mcp.json                # Official VSCode MCP config
ā”‚   ā”œā”€ā”€ settings.json           # Workspace settings
ā”‚   ā”œā”€ā”€ launch.json             # Debug configurations
ā”‚   ā””ā”€ā”€ extensions.json         # Recommended extensions
ā”œā”€ā”€ LICENSE                     # MIT license
ā”œā”€ā”€ README.md                   # Comprehensive documentation
ā”œā”€ā”€ VSCODE_SETUP.md             # VSCode integration guide
ā”œā”€ā”€ advanced_mcp_server.py      # Main MCP server with all tools
ā”œā”€ā”€ aws_cost_analyzer.py        # AWS cost analysis engine
ā”œā”€ā”€ stock_market_analyzer.py    # Stock market analysis engine
ā”œā”€ā”€ snowflake_cost_analyzer.py  # Snowflake cost monitoring engine
ā”œā”€ā”€ run_http_server.py          # Flexible server runner
ā”œā”€ā”€ claude_config.json          # Claude Desktop configuration
ā”œā”€ā”€ requirements.txt            # Python dependencies
ā””ā”€ā”€ setup_env.py               # Environment setup utility

šŸ” Troubleshooting

AWS Issues

  • No profiles found: Run aws configure to set up credentials
  • Permission denied: Ensure your AWS user has Cost Explorer permissions
  • Region errors: Cost Explorer API requires us-east-1 region

General Issues

  • Import errors: Ensure virtual environment is activated
  • API key errors: Check .env file configuration
  • Server startup: Verify all dependencies are installed

šŸš€ Advanced Usage

Custom Cost Analysis

from aws_cost_analyzer import AWSCostAnalyzer

analyzer = AWSCostAnalyzer()
result = analyzer.analyze_all_profiles(days=7)  # Last 7 days
print(result)

HTTP API Integration

# Start HTTP server
export MCP_TRANSPORT=http
python run_http_server.py

# Test AWS cost analysis via HTTP
curl -X POST http://localhost:8000 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"analyze_aws_costs","arguments":{"days":30}}}'

šŸ“š Documentation

šŸ¤ Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests for new functionality
  5. Submit a pull request

šŸ“„ License

This project is licensed under the MIT License.

šŸ™ Acknowledgments

  • FastMCP: Excellent MCP framework
  • AWS SDK: Boto3 for AWS integration
  • OpenWeather: Weather data API
  • DuckDuckGo: Web search API