Upload 2 files

EasyReportDataMCP/edgar_client.py

@@ -397,15 +397,25 @@ class EdgarDataClient:
             print("sec_edgar_api library not installed")
             return []
         
+        # ✅ 添加调试日志
+        print(f"[DEBUG] get_company_filings called with CIK: {cik}, form_types: {form_types}")
+        
         # Convert list to tuple for caching (lists are not hashable)
         if form_types and isinstance(form_types, list):
             form_types = tuple(form_types)
             
         try:
             self._rate_limit()
+            # ✅ 调试: 打印实际调用SEC API的CIK
+            print(f"[DEBUG] Calling SEC API get_submissions with CIK: {cik}")
+            
             # Get company submissions (now has timeout protection)
             submissions = self.edgar.get_submissions(cik=cik)
             
+            # ✅ 调试: 打印返回的基本信息
+            print(f"[DEBUG] Got submissions for: {submissions.get('name', 'Unknown')}")
+            print(f"[DEBUG] Available form types in recent filings: {set(submissions.get('filings', {}).get('recent', {}).get('form', [])[:20])}")
+            
             # Extract filing information
             filings = []
             recent = submissions.get("filings", {}).get("recent", {})
@@ -437,6 +447,11 @@ class EdgarDataClient:
                 
                 filings.append(filing)
             
+            # ✅ 调试: 打印过滤后的结果
+            print(f"[DEBUG] After filtering, found {len(filings)} filings matching form_types: {form_types}")
+            if len(filings) > 0:
+                print(f"[DEBUG] First filing: {filings[0]}")
+            
             return filings
         except TimeoutError as e:
             print(f"Timeout getting company filings for CIK {cik}: {e}")

EasyReportDataMCP/mcp_server_fastmcp.py

@@ -213,15 +213,29 @@ def extract_financial_metrics(cik: str, years: int = 3) -> dict:
     if years < 1 or years > 10:
         return {"error": "Years parameter must be between 1 and 10"}
     
+    # ✅ 添加调试日志,查看实际CIK格式和查询结果
+    print(f"[DEBUG] extract_financial_metrics called with CIK: {cik}, type: {type(cik)}, years: {years}")
+    
     # Check if company has filings (use tuple for caching)
     filings_10k = edgar_client.get_company_filings(cik, ('10-K',))
     filings_20f = edgar_client.get_company_filings(cik, ('20-F',))
+    
+    # ✅ 打印查询结果
+    print(f"[DEBUG] Found {len(filings_10k)} 10-K filings, {len(filings_20f)} 20-F filings")
+    if len(filings_10k) > 0:
+        print(f"[DEBUG] Latest 10-K: {filings_10k[0]}")
+    if len(filings_20f) > 0:
+        print(f"[DEBUG] Latest 20-F: {filings_20f[0]}")
+    
     total_filings = len(filings_10k) + len(filings_20f)
     
     if total_filings == 0:
+        # ✅ 提供更详细的错误信息,帮助用户了解问题
         return {
-            "error": f"No annual filings found for CIK: {cik}",
-            "suggestion": "Please check if the CIK is correct"
+            "error": f"No 10-K or 20-F annual filings found for CIK: {cik}",
+            "suggestion": "This company might not have filed 10-K or 20-F forms yet. Please verify the CIK is correct.",
+            "note": "Some companies may use different filing forms or may be newly listed.",
+            "cik": cik
         }
     
     # Extract metrics
@@ -302,7 +316,13 @@ def get_latest_financial_data(cik: str) -> dict:
     if result and "period" in result:
         return result
     else:
-        return {"error": f"No latest financial data found for CIK: {cik}"}
+        # ✅ 提供更有帮助的错误信息
+        return {
+            "error": f"No latest financial data found for CIK: {cik}",
+            "suggestion": "The company may not have recent 10-K or 20-F filings, or the data format may not be supported.",
+            "note": "Try using a different CIK or check if the company has filed recent annual reports.",
+            "cik": cik
+        }
 
 
 @mcp.tool()