TWSE MCP Server

"""Company listing related tools.""" from utils import TWSEAPIClient def register_tools(mcp): """Register company listing tools with the MCP instance.""" @mcp.tool def get_foreign_companies_applying_for_listing() -> str: """Get foreign companies applying for first listing on TWSE.""" try: data = TWSEAPIClient.get_data("/company/applylistingForeign") if not data: return "目前沒有外國公司申請第一上市資料。" result = f"共有 {len(data)} 筆外國公司申請第一上市資料：\n\n" for item in data[:20]: # Limit to first 20 for readability company_name = item.get("公司名稱", "N/A") application_date = item.get("申請日期", "N/A") status = item.get("狀態", "N/A") result += f"- {company_name}: 申請日期 {application_date}, 狀態 {status}\n" if len(data) > 20: result += f"\n... 還有 {len(data) - 20} 筆資料" return result except Exception as e: return f"查詢失敗: {str(e)}" @mcp.tool def get_recently_listed_companies() -> str: """Get recently listed companies.""" try: data = TWSEAPIClient.get_data("/company/newlisting") if not data: return "目前沒有最近上市公司資料。" result = f"共有 {len(data)} 筆最近上市公司資料：\n\n" for item in data[:20]: # Limit to first 20 for readability company_code = item.get("公司代號", "N/A") company_name = item.get("公司名稱", "N/A") listing_date = item.get("上市日期", "N/A") result += f"- {company_name} ({company_code}): 上市日期 {listing_date}\n" if len(data) > 20: result += f"\n... 還有 {len(data) - 20} 筆資料" return result except Exception as e: return f"查詢失敗: {str(e)}" @mcp.tool def get_suspended_listed_companies() -> str: """Get companies whose listing has been suspended.""" try: data = TWSEAPIClient.get_data("/company/suspendListingCsvAndHtml") if not data: return "目前沒有終止上市公司資料。" result = f"共有 {len(data)} 筆終止上市公司資料：\n\n" for item in data[:20]: # Limit to first 20 for readability company_code = item.get("公司代號", "N/A") company_name = item.get("公司名稱", "N/A") suspension_date = item.get("終止日期", "N/A") reason = item.get("終止原因", "N/A") result += f"- {company_name} ({company_code}): 終止日期 {suspension_date}, 原因 {reason}\n" if len(data) > 20: result += f"\n... 還有 {len(data) - 20} 筆資料" return result except Exception as e: return f"查詢失敗: {str(e)}" @mcp.tool def get_local_companies_applying_for_listing() -> str: """Get local companies applying for listing.""" try: data = TWSEAPIClient.get_data("/company/applylistingLocal") if not data: return "目前沒有申請上市之本國公司資料。" result = f"共有 {len(data)} 筆申請上市之本國公司資料：\n\n" for item in data[:20]: # Limit to first 20 for readability company_name = item.get("公司名稱", "N/A") application_date = item.get("申請日期", "N/A") status = item.get("狀態", "N/A") result += f"- {company_name}: 申請日期 {application_date}, 狀態 {status}\n" if len(data) > 20: result += f"\n... 還有 {len(data) - 20} 筆資料" return result except Exception as e: return f"查詢失敗: {str(e)}"