Upload 4 files

Dockerfile

@@ -1,4 +1,4 @@
-FROM python:3.10-slim
+FROM python:3.10-slim
 
 WORKDIR /app
 
@@ -13,6 +13,7 @@ RUN pip install --no-cache-dir -r requirements.txt
 COPY edgar_client.py .
 COPY financial_analyzer.py .
 COPY mcp_server_fastmcp.py .
+COPY app.py .
 
 # Expose port
 EXPOSE 7860
@@ -26,5 +27,5 @@ ENV HOST=0.0.0.0
 # Health check
 HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 CMD curl -f http://localhost:7860/ || exit 1
 
-# Run MCP Server
-CMD ["python", "mcp_server_fastmcp.py"]
+# Run Gradio UI (which starts MCP server internally)
+CMD ["python", "app.py"]

README.md

@@ -5,6 +5,7 @@ colorFrom: blue
 colorTo: green
 sdk: docker
 app_port: 7860
+app_file: app.py
 pinned: false
 ---
 

app.py

@@ -0,0 +1,409 @@
+"""
+Gradio UI for SEC Financial Data MCP Server
+Provides usage guide and examples for MCP clients
+"""
+import gradio as gr
+import subprocess
+import os
+
+# Start MCP server in background
+mcp_process = None
+
+def start_mcp_server():
+    """Start the MCP server in background"""
+    global mcp_process
+    if mcp_process is None:
+        mcp_process = subprocess.Popen(
+            ["python", "mcp_server_fastmcp.py"],
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE
+        )
+
+# Start server on module load
+start_mcp_server()
+
+# Usage guide content
+USAGE_GUIDE = """
+# 📊 SEC Financial Data MCP Server
+
+Welcome! This is a **Model Context Protocol (MCP)** server providing access to SEC EDGAR financial data.
+
+## 🔗 MCP Endpoint
+
+```
+https://jc321-easyreportsmcpserver.hf.space/sse
+```
+
+## 🛠️ Available Tools (7)
+
+1. **search_company** - Search for a company by name
+2. **get_company_info** - Get detailed company information
+3. **get_company_filings** - Get list of SEC filings
+4. **get_financial_data** - Get financial data for a specific period
+5. **extract_financial_metrics** - Extract multi-year financial metrics
+6. **get_latest_financial_data** - Get the most recent financial data
+7. **advanced_search_company** - Advanced search supporting name/CIK
+
+---
+
+## 📝 How to Use
+
+### Option 1: MCP Client (Recommended)
+
+**Claude Desktop Configuration:**
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "sec-financial-data": {
+      "url": "https://jc321-easyreportsmcpserver.hf.space/sse",
+      "transport": "sse"
+    }
+  }
+}
+```
+
+**Then ask Claude:**
+- "Search for Tesla's financial information"
+- "Get Apple's latest financial data"
+- "Show me Microsoft's revenue trends for the last 3 years"
+
+### Option 2: Direct API Call
+
+**Example: List Available Tools**
+
+```bash
+curl -X POST https://jc321-easyreportsmcpserver.hf.space/sse \\
+  -H "Content-Type: application/json" \\
+  -d '{
+    "jsonrpc": "2.0",
+    "method": "tools/list",
+    "id": 1
+  }'
+```
+
+**Example: Search Company**
+
+```bash
+curl -X POST https://jc321-easyreportsmcpserver.hf.space/sse \\
+  -H "Content-Type: application/json" \\
+  -d '{
+    "jsonrpc": "2.0",
+    "method": "tools/call",
+    "params": {
+      "name": "search_company",
+      "arguments": {
+        "company_name": "Tesla"
+      }
+    },
+    "id": 2
+  }'
+```
+
+**Example: Get 3-Year Financial Trends**
+
+```bash
+curl -X POST https://jc321-easyreportsmcpserver.hf.space/sse \\
+  -H "Content-Type: application/json" \\
+  -d '{
+    "jsonrpc": "2.0",
+    "method": "tools/call",
+    "params": {
+      "name": "extract_financial_metrics",
+      "arguments": {
+        "cik": "0001318605",
+        "years": 3
+      }
+    },
+    "id": 3
+  }'
+```
+
+---
+
+## 🔑 Key Features
+
+- ✅ **Pure JSON responses** - No emoji or formatting, easy to parse
+- ✅ **Chronological ordering** - Data sorted newest first (FY → Q4 → Q3 → Q2 → Q1)
+- ✅ **Comprehensive metrics** - Revenue, Net Income, EPS, Operating Expenses, Cash Flow
+- ✅ **Real-time data** - Direct access to SEC EDGAR database
+- ✅ **7 powerful tools** - Search, analyze, and extract financial data
+
+---
+
+## 📚 Tool Reference
+
+### 1. search_company
+Search for a company by name.
+
+**Parameters:**
+- `company_name` (string): Company name (e.g., "Microsoft", "Apple")
+
+**Returns:** Company CIK, name, tickers, SIC code
+
+### 2. get_company_info
+Get detailed company information.
+
+**Parameters:**
+- `cik` (string): Company CIK code (10-digit format)
+
+**Returns:** Full company details
+
+### 3. get_company_filings
+Get list of SEC filings.
+
+**Parameters:**
+- `cik` (string): Company CIK code
+- `form_types` (array, optional): Filter by form types (e.g., ["10-K", "10-Q"])
+
+**Returns:** List of filings with dates and links (max 20)
+
+### 4. get_financial_data
+Get financial data for a specific period.
+
+**Parameters:**
+- `cik` (string): Company CIK code
+- `period` (string): Period in format "YYYY" or "YYYYQX" (e.g., "2024", "2024Q3")
+
+**Returns:** Financial data for the period
+
+### 5. extract_financial_metrics
+Extract comprehensive financial metrics for multiple years.
+
+**Parameters:**
+- `cik` (string): Company CIK code
+- `years` (integer): Number of recent years (1-10, default: 3)
+
+**Returns:** Multi-year financial data with both annual and quarterly metrics
+
+### 6. get_latest_financial_data
+Get the most recent financial data available.
+
+**Parameters:**
+- `cik` (string): Company CIK code
+
+**Returns:** Latest available financial data
+
+### 7. advanced_search_company
+Advanced search supporting both company name and CIK code.
+
+**Parameters:**
+- `company_input` (string): Company name, ticker, or CIK code
+
+**Returns:** Company information
+
+---
+
+## 🌐 Data Source
+
+All data is sourced from the **SEC EDGAR database** - the official financial disclosure system of the U.S. Securities and Exchange Commission.
+
+## 📞 Support
+
+For issues or questions, visit: [GitHub Repository](https://github.com/yourusername/EasyReportDateMCP)
+
+---
+
+**Status:** 🟢 Server Running | **Protocol:** MCP 2024-11-05 | **Transport:** SSE
+"""
+
+EXAMPLE_CODE = """
+# Python Example using MCP SDK
+
+```python
+from mcp import ClientSession, StdioServerParameters
+from mcp.client.stdio import stdio_client
+
+# Connect to MCP server
+server_params = StdioServerParameters(
+    command="curl",
+    args=[
+        "-X", "POST",
+        "https://jc321-easyreportsmcpserver.hf.space/sse",
+        "-H", "Content-Type: application/json",
+        "-d", "@-"
+    ]
+)
+
+async with stdio_client(server_params) as (read, write):
+    async with ClientSession(read, write) as session:
+        # List available tools
+        tools = await session.list_tools()
+        print(f"Available tools: {tools}")
+        
+        # Search for a company
+        result = await session.call_tool(
+            "search_company",
+            arguments={"company_name": "Tesla"}
+        )
+        print(f"Company info: {result}")
+        
+        # Get financial metrics
+        metrics = await session.call_tool(
+            "extract_financial_metrics",
+            arguments={"cik": "0001318605", "years": 3}
+        )
+        print(f"Financial data: {metrics}")
+```
+
+# JavaScript Example
+
+```javascript
+// Using SSE client
+const evtSource = new EventSource(
+  'https://jc321-easyreportsmcpserver.hf.space/sse'
+);
+
+// Send request
+fetch('https://jc321-easyreportsmcpserver.hf.space/sse', {
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify({
+    jsonrpc: '2.0',
+    method: 'tools/call',
+    params: {
+      name: 'search_company',
+      arguments: { company_name: 'Apple' }
+    },
+    id: 1
+  })
+})
+.then(response => response.json())
+.then(data => console.log(data));
+```
+"""
+
+# Create Gradio interface
+with gr.Blocks(title="SEC Financial Data MCP Server", theme=gr.themes.Soft()) as demo:
+    gr.Markdown("# 📊 SEC Financial Data MCP Server")
+    gr.Markdown("### Access real-time SEC EDGAR financial data via Model Context Protocol")
+    
+    with gr.Tabs():
+        with gr.Tab("📖 Usage Guide"):
+            gr.Markdown(USAGE_GUIDE)
+        
+        with gr.Tab("💻 Code Examples"):
+            gr.Markdown(EXAMPLE_CODE)
+        
+        with gr.Tab("🧪 Quick Test"):
+            gr.Markdown("### Test the MCP Server")
+            
+            with gr.Row():
+                with gr.Column():
+                    test_method = gr.Dropdown(
+                        choices=["tools/list", "search_company", "extract_financial_metrics"],
+                        label="Select Test Method",
+                        value="search_company"
+                    )
+                    company_name = gr.Textbox(
+                        label="Company Name (for search_company)",
+                        value="Tesla",
+                        visible=True
+                    )
+                    cik_input = gr.Textbox(
+                        label="CIK (for extract_financial_metrics)",
+                        value="0001318605",
+                        visible=False
+                    )
+                    years_input = gr.Number(
+                        label="Years (for extract_financial_metrics)",
+                        value=3,
+                        visible=False
+                    )
+                    test_btn = gr.Button("🚀 Test", variant="primary")
+                
+                with gr.Column():
+                    result_output = gr.JSON(label="Response")
+            
+            def update_inputs(method):
+                if method == "tools/list":
+                    return gr.update(visible=False), gr.update(visible=False), gr.update(visible=False)
+                elif method == "search_company":
+                    return gr.update(visible=True), gr.update(visible=False), gr.update(visible=False)
+                else:  # extract_financial_metrics
+                    return gr.update(visible=False), gr.update(visible=True), gr.update(visible=True)
+            
+            test_method.change(
+                update_inputs,
+                inputs=[test_method],
+                outputs=[company_name, cik_input, years_input]
+            )
+            
+            def test_mcp_call(method, company, cik, years):
+                import requests
+                import json
+                
+                url = "https://jc321-easyreportsmcpserver.hf.space/sse"
+                
+                if method == "tools/list":
+                    payload = {
+                        "jsonrpc": "2.0",
+                        "method": "tools/list",
+                        "id": 1
+                    }
+                elif method == "search_company":
+                    payload = {
+                        "jsonrpc": "2.0",
+                        "method": "tools/call",
+                        "params": {
+                            "name": "search_company",
+                            "arguments": {"company_name": company}
+                        },
+                        "id": 2
+                    }
+                else:  # extract_financial_metrics
+                    payload = {
+                        "jsonrpc": "2.0",
+                        "method": "tools/call",
+                        "params": {
+                            "name": "extract_financial_metrics",
+                            "arguments": {"cik": cik, "years": int(years)}
+                        },
+                        "id": 3
+                    }
+                
+                try:
+                    response = requests.post(url, json=payload, timeout=10)
+                    return response.json()
+                except Exception as e:
+                    return {"error": str(e)}
+            
+            test_btn.click(
+                test_mcp_call,
+                inputs=[test_method, company_name, cik_input, years_input],
+                outputs=[result_output]
+            )
+        
+        with gr.Tab("ℹ️ About"):
+            gr.Markdown("""
+            ## About This Server
+            
+            **Version:** 1.0.0 (FastMCP)  
+            **Protocol:** Model Context Protocol (MCP) 2024-11-05  
+            **Transport:** Server-Sent Events (SSE)  
+            **Data Source:** SEC EDGAR Database  
+            
+            ### Technology Stack
+            - **Framework:** Anthropic FastMCP SDK
+            - **API:** SEC EDGAR API
+            - **Deployment:** Hugging Face Spaces
+            
+            ### Features
+            - ✅ 7 financial data tools
+            - ✅ Real-time SEC EDGAR access
+            - ✅ Pure JSON responses
+            - ✅ Chronological data ordering
+            - ✅ Comprehensive financial metrics
+            
+            ### Maintained by
+            Juntao Peng (jtyxabc@gmail.com)
+            
+            ### License
+            MIT License
+            """)
+
+# Launch the interface
+if __name__ == "__main__":
+    demo.launch(server_name="0.0.0.0", server_port=7860)

requirements.txt

@@ -1,6 +1,7 @@
-mcp[cli]==1.2.0
+mcp[cli]==1.2.0
 fastapi==0.109.0
 uvicorn[standard]>=0.30
 pydantic>=2.10.1
 sec-edgar-api==1.1.0
 requests==2.31.0
+gradio==4.44.0