Spaces:

JC321
/

EasyReportDataMCP

Runtime error

App Files Files Community

JC321 commited on Nov 27, 2025

Commit

e14b845

verified ·

1 Parent(s): c2c49f9

Upload 2 files

Browse files

Files changed (2) hide show

app.py +188 -370
requirements.txt +0 -1

app.py CHANGED Viewed

@@ -1,409 +1,227 @@
 """
-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)

 """
+Simple FastAPI web interface for MCP Server usage guide
+Runs alongside MCP server
 """
+from fastapi import FastAPI
+from fastapi.responses import HTMLResponse
 import subprocess
+import threading
+import uvicorn
+app = FastAPI(title="SEC Financial Data MCP Server")
+# Start MCP server in background thread
 def start_mcp_server():
+    subprocess.Popen(["python", "mcp_server_fastmcp.py"])
+threading.Thread(target=start_mcp_server, daemon=True).start()
+HTML_CONTENT = """
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>SEC Financial Data MCP Server</title>
+    <style>
+        body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; max-width: 1200px; margin: 0 auto; padding: 20px; background: #f5f5f5; }
+        .container { background: white; border-radius: 8px; padding: 30px; box-shadow: 0 2px 4px rgba(0,0,0,0.1); }
+        h1 { color: #2563eb; border-bottom: 3px solid #2563eb; padding-bottom: 10px; }
+        h2 { color: #1e40af; margin-top: 30px; }
+        h3 { color: #1e3a8a; }
+        .endpoint { background: #e0e7ff; padding: 15px; border-radius: 5px; margin: 15px 0; font-family: monospace; }
+        .tool { background: #f0f9ff; border-left: 4px solid #2563eb; padding: 15px; margin: 10px 0; }
+        .tool-name { font-weight: bold; color: #1e40af; font-size: 18px; }
+        .code { background: #1e293b; color: #e2e8f0; padding: 15px; border-radius: 5px; overflow-x: auto; margin: 10px 0; }
+        .code pre { margin: 0; }
+        .badge { display: inline-block; padding: 4px 12px; border-radius: 12px; font-size: 12px; font-weight: bold; }
+        .badge-success { background: #dcfce7; color: #166534; }
+        .badge-info { background: #dbeafe; color: #1e40af; }
+        .feature { display: inline-block; margin: 5px; padding: 8px 15px; background: #e0e7ff; border-radius: 5px; }
+        table { width: 100%; border-collapse: collapse; margin: 15px 0; }
+        th, td { padding: 12px; text-align: left; border-bottom: 1px solid #e5e7eb; }
+        th { background: #f3f4f6; font-weight: 600; }
+        .status { position: fixed; top: 20px; right: 20px; background: #22c55e; color: white; padding: 10px 20px; border-radius: 20px; }
+    </style>
+</head>
+<body>
+    <div class="status">🟢 Server Running</div>
+    <div class="container">
+        <h1>📊 SEC Financial Data MCP Server</h1>
+        <p style="font-size: 18px; color: #64748b;">Access real-time SEC EDGAR financial data via Model Context Protocol</p>
+        <h2>🔗 MCP Endpoint</h2>
+        <div class="endpoint">
+            https://jc321-easyreportsmcpserver.hf.space/sse
+        </div>
+        <p><span class="badge badge-info">Protocol: MCP 2024-11-05</span> <span class="badge badge-info">Transport: SSE</span></p>
+        <h2>🛠️ Available Tools (7)</h2>
+        <div class="tool">
+            <div class="tool-name">1. search_company</div>
+            <p>Search for a company by name</p>
+            <strong>Parameters:</strong>
+            <ul>
+                <li><code>company_name</code> (string): Company name (e.g., "Tesla", "Apple")</li>
+            </ul>
+            <strong>Returns:</strong> Company CIK, name, tickers, SIC code
+        </div>
+        <div class="tool">
+            <div class="tool-name">2. get_company_info</div>
+            <p>Get detailed company information</p>
+            <strong>Parameters:</strong>
+            <ul>
+                <li><code>cik</code> (string): Company CIK code (10-digit format)</li>
+            </ul>
+        </div>
+        <div class="tool">
+            <div class="tool-name">3. get_company_filings</div>
+            <p>Get list of SEC filings (10-K, 10-Q, etc.)</p>
+            <strong>Parameters:</strong>
+            <ul>
+                <li><code>cik</code> (string): Company CIK code</li>
+                <li><code>form_types</code> (array, optional): Filter by form types</li>
+            </ul>
+        </div>
+        <div class="tool">
+            <div class="tool-name">4. get_financial_data</div>
+            <p>Get financial data for a specific period</p>
+            <strong>Parameters:</strong>
+            <ul>
+                <li><code>cik</code> (string): Company CIK code</li>
+                <li><code>period</code> (string): Period format "YYYY" or "YYYYQX"</li>
+            </ul>
+        </div>
+        <div class="tool">
+            <div class="tool-name">5. extract_financial_metrics ⭐</div>
+            <p>Extract comprehensive financial metrics for multiple years (annual + quarterly)</p>
+            <strong>Parameters:</strong>
+            <ul>
+                <li><code>cik</code> (string): Company CIK code</li>
+                <li><code>years</code> (integer): Number of years (1-10, default: 3)</li>
+            </ul>
+            <strong>Returns:</strong> Multi-year data sorted newest first (FY → Q4 → Q3 → Q2 → Q1)
+        </div>
+        <div class="tool">
+            <div class="tool-name">6. get_latest_financial_data</div>
+            <p>Get the most recent financial data available</p>
+            <strong>Parameters:</strong>
+            <ul>
+                <li><code>cik</code> (string): Company CIK code</li>
+            </ul>
+        </div>
+        <div class="tool">
+            <div class="tool-name">7. advanced_search_company</div>
+            <p>Advanced search supporting both company name and CIK code</p>
+            <strong>Parameters:</strong>
+            <ul>
+                <li><code>company_input</code> (string): Company name, ticker, or CIK</li>
+            </ul>
+        </div>
+        <h2>📝 How to Use</h2>
+        <h3>Option 1: Claude Desktop (Recommended)</h3>
+        <p>Add to your <code>claude_desktop_config.json</code>:</p>
+        <div class="code"><pre>{
   "mcpServers": {
     "sec-financial-data": {
       "url": "https://jc321-easyreportsmcpserver.hf.space/sse",
       "transport": "sse"
     }
   }
+}</pre></div>
+        <p><strong>Then ask Claude:</strong></p>
+        <ul>
+            <li>"Search for Tesla's financial information"</li>
+            <li>"Get Apple's latest financial data"</li>
+            <li>"Show me Microsoft's revenue trends for the last 3 years"</li>
+        </ul>
+        <h3>Option 2: Direct API Call</h3>
+        <p><strong>List Available Tools:</strong></p>
+        <div class="code"><pre>curl -X POST https://jc321-easyreportsmcpserver.hf.space/sse \\
   -H "Content-Type: application/json" \\
   -d '{
     "jsonrpc": "2.0",
     "method": "tools/list",
     "id": 1
+  }'</pre></div>
+        <p><strong>Search Company (Tesla):</strong></p>
+        <div class="code"><pre>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
+  }'</pre></div>
+        <p><strong>Get 3-Year Financial Trends:</strong></p>
+        <div class="code"><pre>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
+  }'</pre></div>
+        <h2>🔑 Key Features</h2>
+        <div class="feature">✅ Pure JSON responses</div>
+        <div class="feature">✅ Chronological ordering</div>
+        <div class="feature">✅ Comprehensive metrics</div>
+        <div class="feature">✅ Real-time SEC EDGAR data</div>
+        <div class="feature">✅ 7 powerful tools</div>
+        <h2>📊 Response Example</h2>
+        <div class="code"><pre>{
+  "jsonrpc": "2.0",
+  "id": 2,
+  "result": {
+    "content": [{
+      "type": "text",
+      "text": "{\\"cik\\":\\"0001318605\\",\\"name\\":\\"TESLA, INC.\\",\\"tickers\\":[\\"TSLA\\"]}"
+    }]
+  }
+}</pre></div>
+        <h2>ℹ️ About</h2>
+        <table>
+            <tr><th>Version</th><td>1.0.0 (FastMCP)</td></tr>
+            <tr><th>Protocol</th><td>Model Context Protocol (MCP) 2024-11-05</td></tr>
+            <tr><th>Transport</th><td>Server-Sent Events (SSE)</td></tr>
+            <tr><th>Data Source</th><td>SEC EDGAR Database</td></tr>
+            <tr><th>Framework</th><td>Anthropic FastMCP SDK</td></tr>
+            <tr><th>Maintained by</th><td>Juntao Peng (jtyxabc@gmail.com)</td></tr>
+        </table>
+        <p style="text-align: center; color: #64748b; margin-top: 40px;">
+            <strong>Status:</strong> <span class="badge badge-success">Online</span> |
+            <strong>Uptime:</strong> Always-On
+        </p>
+    </div>
+</body>
+</html>
+"""
+@app.get("/", response_class=HTMLResponse)
+async def root():
+    return HTML_CONTENT
 if __name__ == "__main__":
+    uvicorn.run(app, host="0.0.0.0", port=7860)

requirements.txt CHANGED Viewed

@@ -4,4 +4,3 @@ uvicorn[standard]>=0.30
 pydantic>=2.10.1
 sec-edgar-api==1.1.0
 requests==2.31.0
-gradio>=5.0.0

 pydantic>=2.10.1
 sec-edgar-api==1.1.0
 requests==2.31.0