Hollaugo Financial Research Server

БесплатноНе проверен

Analyze stocks with summaries, price targets, and analyst recommendations. Track SEC filings, divi…

Описание

Analyze stocks with summaries, price targets, and analyst recommendations. Track SEC filings, divi…

README

A comprehensive collection of production-ready AI agent implementations showcasing different frameworks, protocols, and integration patterns. This repository demonstrates various approaches to building intelligent agents with Model Context Protocol (MCP), multi-agent systems, and real-world integrations.

Repository Overview

This repository contains multiple agent implementations, each demonstrating different architectural patterns and use cases:

Project	Framework	Key Features	Use Case
agent2agent	LangGraph + A2A Protocol	Remote agent communication, Slack integration	Investment research
mcp-financial	FastMCP + FastAPI	ASGI integration, CLI client	Financial data analysis
bright-mcp-server-overview	Dual: LangGraph + ADK	Memory persistence, extended timeouts	Web scraping & research
fpl-deepagent	FastMCP + React UI	Streamable HTTP, ChatGPT integration	Fantasy Premier League
task-manager-app	FastMCP + React UI + Supabase	OAuth (Auth0), per-user DB state, Slack notifications	Task management in ChatGPT
notion-mcp-agent	LangGraph + MCP	Notion integration, database management	Knowledge management
claude-advanced-tool-use	Claude API + FastMCP	PTC, Tool Search, MCP integration	Token-efficient AI agents
claude-skills	Claude Skills API	Document generation, custom skills	PowerPoint, Excel, Word creation
openai-chatkit-starter-app	Next.js + ChatKit	Agent Builder integration, web component	ChatKit UI development
mastra-overview	Mastra framework	Multi-LLM orchestration	Framework exploration
smithery-example	Smithery + FastMCP	MCP playground, development tools	MCP development
mcp-apps	MCP Apps (OpenAI Apps SDK)	Example MCP Apps (weather + stock analysis)	MCP Apps reference implementations

Project Descriptions

agent2agent/

Investment Research Analyst Agent

A production-ready investment research agent implementing Google's Agent-to-Agent (A2A) protocol for remote agent communication.

Key Features:

Framework: LangGraph with LangChain
Protocol: Agent-to-Agent (A2A) for remote communication
Integration: Slack with Block Kit UI and metadata modals
Architecture: FastAPI server exposing both A2A endpoints and Slack events
Memory: Persistent conversation state management
Deployment: Docker ready with Render.com configuration

Technical Stack:

LangGraph for agent orchestration
FastAPI for A2A protocol implementation
Slack Block Kit for interactive UI
LangSmith for observability (optional)
Docker for containerized deployment

Use Cases:

Stock summaries and analysis
SEC filings research
Analyst recommendations
Financial data aggregation
Investment research workflows

mcp-financial/

Investment Analyst MCP Agent

A financial data agent powered by FastMCP with ASGI integration, providing both CLI and Slack interfaces.

Key Features:

Framework: FastMCP with FastAPI ASGI integration
Interfaces: CLI client and Slack bot
Architecture: MCP server exposed via FastAPI endpoints
Integration: Direct Slack event handling
Deployment: Production-ready with health checks

Technical Stack:

FastMCP for Model Context Protocol implementation
FastAPI for ASGI integration
Uvicorn for server runtime
Slack API for bot functionality
MCP Inspector for debugging

Use Cases:

Financial data analysis
Stock price monitoring
Earnings analysis
Market research
Investment insights

bright-mcp-server-overview/

Bright Data MCP Research Agent

A comprehensive research agent powered by Bright Data's web scraping infrastructure, featuring dual AI agent implementations.

Key Features:

Dual Framework: LangGraph (with memory) + Google ADK (with extended timeouts)
Integration: Bright Data MCP server for web scraping
Slack Interface: Interactive agent selection via dropdown
Memory: Persistent conversation memory (LangGraph)
Timeouts: Extended timeout handling (ADK) for long operations
Specialization: SEO research, e-commerce intelligence, market analysis

Technical Stack:

LangGraph Agent: OpenAI GPT with MemorySaver checkpointer
ADK Agent: Google Gemini 2.0 Flash with custom timeout patches
MCP Integration: Bright Data MCP server for data collection
Slack Integration: Bot with agent selection and interactive UI

Agent Comparison:

Feature	LangGraph Agent	ADK Agent
Memory	Persistent (checkpointer)	Context-aware (5 messages)
Timeout	Standard (5s)	Extended (60s)
Model	OpenAI GPT	Gemini 2.0 Flash
Best For	Interactive conversations	Long-running operations

Use Cases:

SEO keyword research and SERP analysis
E-commerce product monitoring and price tracking
Competitor analysis and market intelligence
Web scraping and data collection
Business intelligence and insights

fpl-deepagent/

Fantasy Premier League MCP Assistant

A comprehensive Fantasy Premier League assistant that integrates with ChatGPT through the Model Context Protocol (MCP), featuring beautiful React UI components and real-time FPL data.

Key Features:

Framework: FastMCP with Streamable HTTP transport
UI Integration: React 18 + TypeScript components for ChatGPT
Real-time Data: Live FPL API integration with caching and error handling
Design Compliance: Follows OpenAI Apps SDK design guidelines exactly
Interactive Tools: Player search, detailed stats, and side-by-side comparison

Technical Stack:

FastMCP for MCP server implementation
React 18 + TypeScript for UI components
OpenAI Apps SDK integration with window.openai API
esbuild for fast, modern bundling
Streamable HTTP for bidirectional communication

UI Components:

PlayerListComponent: Interactive player grid with favorites
PlayerDetailComponent: Detailed player stats and upcoming fixtures
PlayerComparisonComponent: Side-by-side comparison with highlighted stats

Use Cases:

Player search and discovery
Detailed player statistics and form analysis
Player comparison for team selection
FPL team optimization
Real-time price and form tracking

task-manager-app/

Task Manager ChatGPT App (Apps SDK + MCP + Supabase + OAuth)

A production-ready tutorial showing how to build a ChatGPT App with:

FastMCP (Streamable HTTP) as the MCP server
React widgets rendered inside ChatGPT
Supabase (Postgres) as authoritative state for tasks/notifications
OAuth (Auth0) for multi-user authentication (MCP OAuth)
Optional Slack notifications (send now + schedule)

Start here:

task-manager-app/README.md

notion-mcp-agent/

Notion Knowledge Management Agent

A sophisticated agent that integrates with Notion through MCP, providing intelligent database management and knowledge organization capabilities.

Key Features:

Framework: LangGraph with MCP integration
Integration: Notion API for database operations
Slack Interface: Interactive knowledge management
Context Management: Intelligent data aggregation
Database Operations: Create, read, update, and organize Notion databases

Technical Stack:

LangGraph for agent orchestration
Notion MCP server for database operations
Slack API for user interaction
Context aggregation for intelligent responses

Use Cases:

Knowledge base management
Database organization and maintenance
Content aggregation and structuring
Team collaboration workflows
Information retrieval and organization

claude-advanced-tool-use/

Claude Advanced Tool Use Tutorial

A comprehensive tutorial demonstrating Anthropic's Advanced Tool Use features: Programmatic Tool Calling (PTC) and Tool Search. These features enable AI agents to scale to thousands of tools while dramatically reducing token usage.

Key Features:

Programmatic Tool Calling (PTC): Claude writes Python code that orchestrates tool calls in a sandbox
Tool Search: Dynamic tool discovery with defer_loading for efficient context usage
MCP Integration: Tool Search combined with MCP servers via mcp_toolset
Real-World Examples: Financial data tools using yfinance
Token Savings: Up to 98% reduction in token usage for complex tasks

Technical Stack:

Anthropic Claude API (Sonnet 4.5)
Beta headers: advanced-tool-use-2025-11-20
FastMCP for MCP server implementation
Python + yfinance for financial data
ngrok for MCP server tunneling

Examples:

01_ptc_token_savings.py - Programmatic Tool Calling with token comparison
02_tool_search.py - Tool Search with 10 deferred financial tools
03_mcp_tool_search.py - MCP + Tool Search via ngrok tunnel
mcp_server.py - FastMCP server exposing financial tools

Key Concepts:

Feature	Description	Token Savings
Programmatic Tool Calling	Tool results stay in sandbox, only `print()` output enters context	37%
Tool Search	Only load tool definitions when discovered	85%
Combined	PTC + Tool Search together	Up to 98%

Use Cases:

Building AI agents with many tools (100+)
Reducing context window bloat from tool definitions
Processing large datasets without context overflow
MCP server integration with dynamic tool discovery
Token-efficient financial analysis agents

claude-skills/

Claude Skills API Implementation

A comprehensive implementation of Claude's Skills API for automated document generation and custom skill creation.

Key Features:

Framework: Claude Skills API with streaming support
Document Generation: PowerPoint, Excel, Word, and PDF creation
Custom Skills: Upload and manage custom skills (8MB limit)
File Management: List, download, and delete generated files
Multi-Skill Workflows: Combine multiple skills in single requests

Technical Stack:

Claude Skills API with beta features
Code execution environment (2025-08-25)
Files API (2025-04-14)
Streaming responses for real-time progress
Python SDK with uv package manager

Utilities:

list-skills.py - List all available skills
create-skill.py - Upload custom skills from directories
use-skill.py - Generate documents with single skills
multi-skill-demo.py - Complex workflows with multiple skills
list-files.py / download-file.py / delete-file.py - File management

Use Cases:

Automated PowerPoint presentation generation
Excel spreadsheet creation and data analysis
Word document generation
PDF report creation
Custom skill development and deployment
Multi-format document workflows

openai-chatkit-starter-app/

ChatKit Web Component Starter

A minimal Next.js starter template for building ChatKit applications with OpenAI's Agent Builder workflows.

Key Features:

Framework: Next.js with ChatKit web component
Integration: OpenAI Agent Builder workflows
Customization: Configurable themes, prompts, and UI
Session Management: Ready-to-use session endpoint
Deployment: Domain allowlist verification support

Technical Stack:

Next.js for application framework
OpenAI ChatKit web component (<openai-chatkit>)
OpenAI API integration
TypeScript for type safety
Configurable theming system

Key Components:

Session creation endpoint (/api/create-session)
ChatKit panel with event handlers
Theme and color scheme controls
Starter prompts configuration
Error overlay for debugging

Use Cases:

ChatKit application prototyping
Agent Builder workflow integration
Custom ChatKit UI development
OpenAI workflow testing
Production ChatKit deployments

mastra-overview/

Mastra Framework Exploration

An exploration of the Mastra framework for multi-LLM orchestration and agent management.

Key Features:

Framework: Mastra for multi-LLM orchestration
Multi-LLM: Support for multiple language models
Orchestration: Intelligent model selection and routing
Polyfills: Crypto polyfills for browser compatibility

Technical Stack:

Mastra framework
Multi-LLM integration
Browser compatibility polyfills
TypeScript configuration

Use Cases:

Multi-LLM agent systems
Model orchestration and routing
Framework exploration and evaluation
LLM comparison and benchmarking

smithery-example/

MCP Development Playground

A comprehensive development environment for MCP (Model Context Protocol) with FastMCP integration and testing tools.

Key Features:

Framework: Smithery + FastMCP
Development Tools: MCP playground and testing environment
Financial Integration: Example financial server implementation
Testing: Comprehensive test suite and examples
Documentation: Development guides and examples

Technical Stack:

Smithery for MCP development
FastMCP for server implementation
Testing frameworks for validation
Development tooling and playgrounds

Use Cases:

MCP server development
Protocol testing and validation
Financial data integration examples
Development environment setup
MCP learning and exploration

mcp-apps/

MCP Apps Examples (Weather + Stock Analysis)

Two minimal example MCP Apps showing how to build UI + server experiences using the MCP Apps extensions.

Key Features:

Weather App: UI + MCP server example with a simple weather workflow
Stock Analysis App: UI + MCP server example for market/stock analysis
Apps SDK: Designed to follow MCP Apps extension patterns
Docs Reference: See the MCP Apps docs for the full guide

Use Cases:

Learning MCP Apps fundamentals
Building UI-backed MCP Apps
Reference implementations for new MCP App projects

Getting Started

Each project includes comprehensive setup instructions in its respective README file. General prerequisites include:

Common Requirements

Python 3.9+ (some projects require newer; see each project README)
Valid API keys for respective services
Slack workspace access (for Slack integrations)
Environment variable configuration

Quick Start Pattern

# 1. Navigate to desired project
cd [project-name]/

# 2. Install dependencies
# Most Python projects here use uv:
uv sync
# Some projects use pip/requirements.txt:
# pip install -r requirements.txt

# 3. Configure environment
cp .env.example .env
# Edit .env with your API keys

# 4. Run the agent
# (varies by project - see individual READMEs)

Architecture Patterns

Model Context Protocol (MCP)

Multiple projects demonstrate different MCP implementation patterns:

FastMCP ASGI: Direct FastAPI integration (mcp-financial, smithery-example)
FastMCP Streamable HTTP: Modern bidirectional communication (fpl-deepagent)
Bright Data MCP: External MCP server communication
Notion MCP: Database and knowledge management integration

Agent Communication

A2A Protocol: Remote agent-to-agent communication (agent2agent)
State Management: Persistent conversation memory (bright-mcp-server-overview)

UI Integration Patterns

React + ChatGPT: OpenAI Apps SDK integration (fpl-deepagent)
Next.js + ChatKit: Agent Builder workflow integration (openai-chatkit-starter-app)
Slack Bots: Event-driven chat interfaces (multiple projects)
CLI Clients: Command-line agent interaction

Document Generation

Claude Skills API: Automated document creation with streaming (claude-skills)
Multi-Format Support: PowerPoint, Excel, Word, PDF generation
Custom Skills: Uploadable skill packages for specialized tasks

Development & Testing

MCP Playground: Development and testing environment (smithery-example)
Multi-LLM Orchestration: Framework exploration (mastra-overview)
Agent Builder: OpenAI workflow development (openai-chatkit-starter-app)

Integration Patterns

Container Deployment: Docker and cloud-ready
API Integration: RESTful agent endpoints
Database Integration: Knowledge management systems
Real-time Data: Live API integration with caching

Contributing

Each project welcomes contributions. Please:

Fork the repository
Create a feature branch
Follow the project's coding standards
Include tests where applicable
Submit a Pull Request

License

MIT License - see individual project LICENSE files for details.

Support & Resources

Documentation Links

Platform-Specific Support

Bright Data: brightdata.com/support
Notion: developers.notion.com
Fantasy Premier League: fpl.readthedocs.io
Slack: api.slack.com/support

Built with ❤️ demonstrating the future of AI agent development

from github.com/hollaugo/tutorials

Установка Hollaugo Financial Research Server

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/hollaugo/tutorials

FAQ