Upload mcp_server_sse.py

mcp_server_sse.py

@@ -24,7 +24,7 @@ from contextlib import contextmanager
 app = FastAPI(
     title="SEC Financial Report MCP Server",
     description="Model Context Protocol Server for SEC EDGAR Financial Data",
-    version="2.2.2"
+    version="2.2.3"
 )
 
 # Server startup time for monitoring
@@ -403,7 +403,7 @@ async def handle_mcp_message(request: MCPRequest):
                 },
                 "serverInfo": {
                     "name": "sec-financial-data",
-                    "version": "2.2.2"
+                    "version": "2.2.3"
                 }
             }
         ).dict()
@@ -658,6 +658,42 @@ async def root():
                 color: #667eea;
                 font-weight: 500;
             }
+            .api-example-box {
+                background: #1e1e1e;
+                border-radius: 4px;
+                padding: 12px;
+                margin: 10px 0;
+                font-family: 'Monaco', 'Courier New', monospace;
+                font-size: 11px;
+                overflow-x: auto;
+            }
+            .api-example-box .api-title {
+                color: #9cdcfe;
+                font-weight: 600;
+                margin-bottom: 8px;
+                display: flex;
+                align-items: center;
+                gap: 5px;
+            }
+            .api-example-box .api-title::before {
+                content: "📡";
+                font-size: 14px;
+            }
+            .api-example-box pre {
+                margin: 0;
+                color: #d4d4d4;
+                white-space: pre-wrap;
+                word-break: break-word;
+            }
+            .api-example-box .json-key {
+                color: #9cdcfe;
+            }
+            .api-example-box .json-string {
+                color: #ce9178;
+            }
+            .api-example-box .json-number {
+                color: #b5cea8;
+            }
             .test-btn {
                 background: linear-gradient(135deg, #667eea, #764ba2);
                 color: white;
@@ -772,6 +808,20 @@ async def root():
                                 <div class="example-item"><span class="example-label">Input:</span> "Tesla"</div>
                             </div>
                         </div>
+                        <div class="api-example-box">
+                            <div class="api-title">API Request Example</div>
+                            <pre>{
+  <span class="json-key">"jsonrpc"</span>: <span class="json-string">"2.0"</span>,
+  <span class="json-key">"id"</span>: <span class="json-number">1</span>,
+  <span class="json-key">"method"</span>: <span class="json-string">"tools/call"</span>,
+  <span class="json-key">"params"</span>: {
+    <span class="json-key">"name"</span>: <span class="json-string">"search_company"</span>,
+    <span class="json-key">"arguments"</span>: {
+      <span class="json-key">"company_name"</span>: <span class="json-string">"Microsoft"</span>
+    }
+  }
+}</pre>
+                        </div>
                         <div class="param-group">
                             <label>Company Name *</label>
                             <input type="text" id="tool1-company_name" placeholder="e.g., Microsoft, Apple, Tesla">
@@ -802,6 +852,20 @@ async def root():
                                 <div class="example-item"><span class="example-label">By Name:</span> "Microsoft Corporation"</div>
                             </div>
                         </div>
+                        <div class="api-example-box">
+                            <div class="api-title">API Request Example</div>
+                            <pre>{
+  <span class="json-key">"jsonrpc"</span>: <span class="json-string">"2.0"</span>,
+  <span class="json-key">"id"</span>: <span class="json-number">1</span>,
+  <span class="json-key">"method"</span>: <span class="json-string">"tools/call"</span>,
+  <span class="json-key">"params"</span>: {
+    <span class="json-key">"name"</span>: <span class="json-string">"advanced_search_company"</span>,
+    <span class="json-key">"arguments"</span>: {
+      <span class="json-key">"company_input"</span>: <span class="json-string">"MSFT"</span>
+    }
+  }
+}</pre>
+                        </div>
                         <div class="param-group">
                             <label>Company Name / Ticker / CIK *</label>
                             <input type="text" id="tool2-company_input" placeholder="e.g., MSFT, 0000789019, Microsoft">
@@ -832,6 +896,20 @@ async def root():
                                 <div class="example-item"><span class="example-label">Tesla:</span> "0001318605"</div>
                             </div>
                         </div>
+                        <div class="api-example-box">
+                            <div class="api-title">API Request Example</div>
+                            <pre>{
+  <span class="json-key">"jsonrpc"</span>: <span class="json-string">"2.0"</span>,
+  <span class="json-key">"id"</span>: <span class="json-number">1</span>,
+  <span class="json-key">"method"</span>: <span class="json-string">"tools/call"</span>,
+  <span class="json-key">"params"</span>: {
+    <span class="json-key">"name"</span>: <span class="json-string">"get_company_info"</span>,
+    <span class="json-key">"arguments"</span>: {
+      <span class="json-key">"cik"</span>: <span class="json-string">"0000789019"</span>
+    }
+  }
+}</pre>
+                        </div>
                         <div class="param-group">
                             <label>CIK Code *</label>
                             <input type="text" id="tool3-cik" placeholder="e.g., 0000789019">
@@ -862,6 +940,21 @@ async def root():
                                 <div class="example-item"><span class="example-label">Or:</span> Leave empty to get all filing types</div>
                             </div>
                         </div>
+                        <div class="api-example-box">
+                            <div class="api-title">API Request Example</div>
+                            <pre>{
+  <span class="json-key">"jsonrpc"</span>: <span class="json-string">"2.0"</span>,
+  <span class="json-key">"id"</span>: <span class="json-number">1</span>,
+  <span class="json-key">"method"</span>: <span class="json-string">"tools/call"</span>,
+  <span class="json-key">"params"</span>: {
+    <span class="json-key">"name"</span>: <span class="json-string">"get_company_filings"</span>,
+    <span class="json-key">"arguments"</span>: {
+      <span class="json-key">"cik"</span>: <span class="json-string">"0000789019"</span>,
+      <span class="json-key">"form_types"</span>: [<span class="json-string">"10-K"</span>, <span class="json-string">"10-Q"</span>]
+    }
+  }
+}</pre>
+                        </div>
                         <div class="param-group">
                             <label>CIK Code *</label>
                             <input type="text" id="tool4-cik" placeholder="e.g., 0000789019">
@@ -901,6 +994,20 @@ async def root():
                                 <div class="example-item"><span class="example-label">NVIDIA:</span> "0001045810"</div>
                             </div>
                         </div>
+                        <div class="api-example-box">
+                            <div class="api-title">API Request Example</div>
+                            <pre>{
+  <span class="json-key">"jsonrpc"</span>: <span class="json-string">"2.0"</span>,
+  <span class="json-key">"id"</span>: <span class="json-number">1</span>,
+  <span class="json-key">"method"</span>: <span class="json-string">"tools/call"</span>,
+  <span class="json-key">"params"</span>: {
+    <span class="json-key">"name"</span>: <span class="json-string">"get_latest_financial_data"</span>,
+    <span class="json-key">"arguments"</span>: {
+      <span class="json-key">"cik"</span>: <span class="json-string">"0000789019"</span>
+    }
+  }
+}</pre>
+                        </div>
                         <div class="param-group">
                             <label>CIK Code *</label>
                             <input type="text" id="tool5-cik" placeholder="e.g., 0000789019">
@@ -930,6 +1037,21 @@ async def root():
                                 <div class="example-item"><span class="example-label">Format:</span> YYYY for annual, YYYYQX for quarterly</div>
                             </div>
                         </div>
+                        <div class="api-example-box">
+                            <div class="api-title">API Request Example</div>
+                            <pre>{
+  <span class="json-key">"jsonrpc"</span>: <span class="json-string">"2.0"</span>,
+  <span class="json-key">"id"</span>: <span class="json-number">1</span>,
+  <span class="json-key">"method"</span>: <span class="json-string">"tools/call"</span>,
+  <span class="json-key">"params"</span>: {
+    <span class="json-key">"name"</span>: <span class="json-string">"get_financial_data"</span>,
+    <span class="json-key">"arguments"</span>: {
+      <span class="json-key">"cik"</span>: <span class="json-string">"0000789019"</span>,
+      <span class="json-key">"period"</span>: <span class="json-string">"2024"</span>
+    }
+  }
+}</pre>
+                        </div>
                         <div class="param-group">
                             <label>CIK Code *</label>
                             <input type="text" id="tool6-cik" placeholder="e.g., 0000789019">
@@ -964,6 +1086,21 @@ async def root():
                                 <div class="example-item"><span class="example-label">Note:</span> Returns annual + quarterly data (if available)</div>
                             </div>
                         </div>
+                        <div class="api-example-box">
+                            <div class="api-title">API Request Example</div>
+                            <pre>{
+  <span class="json-key">"jsonrpc"</span>: <span class="json-string">"2.0"</span>,
+  <span class="json-key">"id"</span>: <span class="json-number">1</span>,
+  <span class="json-key">"method"</span>: <span class="json-string">"tools/call"</span>,
+  <span class="json-key">"params"</span>: {
+    <span class="json-key">"name"</span>: <span class="json-string">"extract_financial_metrics"</span>,
+    <span class="json-key">"arguments"</span>: {
+      <span class="json-key">"cik"</span>: <span class="json-string">"0000789019"</span>,
+      <span class="json-key">"years"</span>: <span class="json-number">3</span>
+    }
+  }
+}</pre>
+                        </div>
                         <div class="param-group">
                             <label>CIK Code *</label>
                             <input type="text" id="tool7-cik" placeholder="e.g., 0000789019">
@@ -1143,7 +1280,7 @@ async def health_check():
     return {
         "status": "healthy",
         "server": "sec-financial-data",
-        "version": "2.2.2",
+        "version": "2.2.3",
         "protocol": "MCP",
         "transport": "SSE",
         "tools_count": len(MCP_TOOLS),