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.1"
+    version="2.2.2"
 )
 
 # Server startup time for monitoring
@@ -403,7 +403,7 @@ async def handle_mcp_message(request: MCPRequest):
                 },
                 "serverInfo": {
                     "name": "sec-financial-data",
-                    "version": "2.2.1"
+                    "version": "2.2.2"
                 }
             }
         ).dict()
@@ -623,6 +623,41 @@ async def root():
                 color: #999;
                 margin-top: 3px;
             }
+            .example-box {
+                background: #f8f9fa;
+                border: 1px solid #dee2e6;
+                border-radius: 4px;
+                padding: 10px;
+                margin: 10px 0;
+                font-size: 12px;
+            }
+            .example-box .example-title {
+                font-weight: 600;
+                color: #495057;
+                margin-bottom: 5px;
+                display: flex;
+                align-items: center;
+                gap: 5px;
+            }
+            .example-box .example-title::before {
+                content: "💡";
+                font-size: 14px;
+            }
+            .example-box .example-content {
+                font-family: 'Monaco', 'Courier New', monospace;
+                color: #6c757d;
+                background: white;
+                padding: 8px;
+                border-radius: 3px;
+                border-left: 3px solid #667eea;
+            }
+            .example-item {
+                margin: 3px 0;
+            }
+            .example-label {
+                color: #667eea;
+                font-weight: 500;
+            }
             .test-btn {
                 background: linear-gradient(135deg, #667eea, #764ba2);
                 color: white;
@@ -729,6 +764,14 @@ async def root():
                         </div>
                     </div>
                     <div class="tool-body" id="tool1">
+                        <div class="example-box">
+                            <div class="example-title">Parameter Format Example</div>
+                            <div class="example-content">
+                                <div class="example-item"><span class="example-label">Input:</span> "Microsoft"</div>
+                                <div class="example-item"><span class="example-label">Input:</span> "Apple Inc"</div>
+                                <div class="example-item"><span class="example-label">Input:</span> "Tesla"</div>
+                            </div>
+                        </div>
                         <div class="param-group">
                             <label>Company Name *</label>
                             <input type="text" id="tool1-company_name" placeholder="e.g., Microsoft, Apple, Tesla">
@@ -751,6 +794,14 @@ async def root():
                         </div>
                     </div>
                     <div class="tool-body" id="tool2">
+                        <div class="example-box">
+                            <div class="example-title">Parameter Format Example</div>
+                            <div class="example-content">
+                                <div class="example-item"><span class="example-label">By Ticker:</span> "MSFT"</div>
+                                <div class="example-item"><span class="example-label">By CIK:</span> "0000789019"</div>
+                                <div class="example-item"><span class="example-label">By Name:</span> "Microsoft Corporation"</div>
+                            </div>
+                        </div>
                         <div class="param-group">
                             <label>Company Name / Ticker / CIK *</label>
                             <input type="text" id="tool2-company_input" placeholder="e.g., MSFT, 0000789019, Microsoft">
@@ -773,6 +824,14 @@ async def root():
                         </div>
                     </div>
                     <div class="tool-body" id="tool3">
+                        <div class="example-box">
+                            <div class="example-title">Parameter Format Example</div>
+                            <div class="example-content">
+                                <div class="example-item"><span class="example-label">Microsoft:</span> "0000789019"</div>
+                                <div class="example-item"><span class="example-label">Apple:</span> "0000320193"</div>
+                                <div class="example-item"><span class="example-label">Tesla:</span> "0001318605"</div>
+                            </div>
+                        </div>
                         <div class="param-group">
                             <label>CIK Code *</label>
                             <input type="text" id="tool3-cik" placeholder="e.g., 0000789019">
@@ -795,6 +854,14 @@ async def root():
                         </div>
                     </div>
                     <div class="tool-body" id="tool4">
+                        <div class="example-box">
+                            <div class="example-title">Parameter Format Example</div>
+                            <div class="example-content">
+                                <div class="example-item"><span class="example-label">CIK:</span> "0000789019" (Microsoft)</div>
+                                <div class="example-item"><span class="example-label">Form Types:</span> Select "10-K" and "10-Q" from dropdown</div>
+                                <div class="example-item"><span class="example-label">Or:</span> Leave empty to get all filing types</div>
+                            </div>
+                        </div>
                         <div class="param-group">
                             <label>CIK Code *</label>
                             <input type="text" id="tool4-cik" placeholder="e.g., 0000789019">
@@ -826,6 +893,14 @@ async def root():
                         </div>
                     </div>
                     <div class="tool-body" id="tool5">
+                        <div class="example-box">
+                            <div class="example-title">Parameter Format Example</div>
+                            <div class="example-content">
+                                <div class="example-item"><span class="example-label">Microsoft:</span> "0000789019"</div>
+                                <div class="example-item"><span class="example-label">Apple:</span> "0000320193"</div>
+                                <div class="example-item"><span class="example-label">NVIDIA:</span> "0001045810"</div>
+                            </div>
+                        </div>
                         <div class="param-group">
                             <label>CIK Code *</label>
                             <input type="text" id="tool5-cik" placeholder="e.g., 0000789019">
@@ -847,6 +922,14 @@ async def root():
                         </div>
                     </div>
                     <div class="tool-body" id="tool6">
+                        <div class="example-box">
+                            <div class="example-title">Parameter Format Example</div>
+                            <div class="example-content">
+                                <div class="example-item"><span class="example-label">Annual Data:</span> CIK="0000789019", Period="2024"</div>
+                                <div class="example-item"><span class="example-label">Quarterly Data:</span> CIK="0000789019", Period="2024Q3"</div>
+                                <div class="example-item"><span class="example-label">Format:</span> YYYY for annual, YYYYQX for quarterly</div>
+                            </div>
+                        </div>
                         <div class="param-group">
                             <label>CIK Code *</label>
                             <input type="text" id="tool6-cik" placeholder="e.g., 0000789019">
@@ -873,6 +956,14 @@ async def root():
                         </div>
                     </div>
                     <div class="tool-body" id="tool7">
+                        <div class="example-box">
+                            <div class="example-title">Parameter Format Example</div>
+                            <div class="example-content">
+                                <div class="example-item"><span class="example-label">3 Years:</span> CIK="0000789019", Years=3</div>
+                                <div class="example-item"><span class="example-label">5 Years:</span> CIK="0000320193", Years=5</div>
+                                <div class="example-item"><span class="example-label">Note:</span> Returns annual + quarterly data (if available)</div>
+                            </div>
+                        </div>
                         <div class="param-group">
                             <label>CIK Code *</label>
                             <input type="text" id="tool7-cik" placeholder="e.g., 0000789019">
@@ -1052,7 +1143,7 @@ async def health_check():
     return {
         "status": "healthy",
         "server": "sec-financial-data",
-        "version": "2.2.1",
+        "version": "2.2.2",
         "protocol": "MCP",
         "transport": "SSE",
         "tools_count": len(MCP_TOOLS),