Upload 2 files

CLIENT_CONFIG_GUIDE.md

@@ -0,0 +1,292 @@
+# 瀹㈡埛绔�厤缃�寚鍗?- SEC Financial Data MCP Server
+
+## 馃敆 鏈嶅姟鍣ㄤ俊�?
+
+**HF Space URL**: `https://jc321-easyreportdatamcp.hf.space`  
+**浼犺緭鍗忚�**: HTTP (JSON-RPC 2.0)  
+**SDK 绫诲�?*: Gradio (涓嶆�?Docker)
+
+---
+
+## 馃摗 鍙�敤鐨?MCP 绔��?
+
+褰撳墠鏈嶅姟鍣ㄦ彁渚涗互�?HTTP 绔�偣鐢ㄤ簬 MCP 瀹㈡埛绔�皟鐢��?
+
+### 绔��?1: `/mcp`
+- **瀹屾�?URL**: `https://jc321-easyreportdatamcp.hf.space/mcp`
+- **鏂规�?*: POST, GET
+- **鍗忚�?*: JSON-RPC 2.0
+
+### 绔��?2: `/sse` 
+- **瀹屾�?URL**: `https://jc321-easyreportdatamcp.hf.space/sse`
+- **鏂规�?*: POST, GET
+- **鍗忚�?*: JSON-RPC 2.0
+
+**娉ㄦ�?*: 涓や釜绔�偣鍔熻兘瀹屽叏鐩稿悓锛屼负浜嗗悜鍚庡吋瀹逛繚鐣欎簡涓や釜璺�緞銆?
+
+---
+
+## 馃洜�?瀹㈡埛绔�厤缃�柟寮?
+
+### 鏂瑰�?1: HTTP 浼犺緭锛堟帹鑽愮敤浜?HF Space�?
+
+```json
+{
+  "mcpServers": {
+    "sec-financial-data": {
+      "url": "https://jc321-easyreportdatamcp.hf.space/mcp",
+      "transport": "http"
+    }
+  }
+}
+```
+
+鎴栬€呬娇鐢?`/sse` 绔�偣锛?
+
+```json
+{
+  "mcpServers": {
+    "sec-financial-data": {
+      "url": "https://jc321-easyreportdatamcp.hf.space/sse",
+      "transport": "http"
+    }
+  }
+}
+```
+
+### 鏂瑰�?2: SSE 浼犺緭锛堝�鏋滃�鎴风�鏀�寔�?
+
+```json
+{
+  "mcpServers": {
+    "sec-financial-data": {
+      "url": "https://jc321-easyreportdatamcp.hf.space/sse",
+      "transport": "sse"
+    }
+  }
+}
+```
+
+---
+
+## 馃搵 鏀�寔�?JSON-RPC 鏂规�?
+
+### 1. 鍒楀嚭鎵€鏈夊伐�?
+```json
+{
+  "jsonrpc": "2.0",
+  "method": "tools/list",
+  "id": 1
+}
+```
+
+**鍝嶅簲绀轰緥**:
+```json
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "result": {
+    "tools": [
+      {
+        "name": "search_company",
+        "description": "Search for a company by name in SEC EDGAR database.",
+        "inputSchema": {...}
+      },
+      ...
+    ]
+  }
+}
+```
+
+### 2. 璋冪敤宸ュ叿
+```json
+{
+  "jsonrpc": "2.0",
+  "method": "tools/call",
+  "params": {
+    "name": "search_company",
+    "arguments": {
+      "company_name": "Tesla"
+    }
+  },
+  "id": 2
+}
+```
+
+**鍝嶅簲绀轰緥**:
+```json
+{
+  "jsonrpc": "2.0",
+  "id": 2,
+  "result": {
+    "content": [
+      {
+        "type": "text",
+        "text": "{\"cik\":\"0001318605\",\"name\":\"Tesla, Inc.\",\"ticker\":\"TSLA\"}"
+      }
+    ]
+  }
+}
+```
+
+---
+
+## 馃敡 鍙�敤鐨?7 涓�伐鍏?
+
+| 宸ュ叿鍚嶇�?| 鍙傛�?| 璇存�?|
+|---------|------|------|
+| `search_company` | `company_name: str` | 鎸夊叕鍙稿悕绉版悳绱?|
+| `get_company_info` | `cik: str` | 鑾峰彇鍏�徃璇︾粏淇℃伅 |
+| `get_company_filings` | `cik: str`, `form_types?: list[str]` | 鑾峰�?SEC 鏂囦欢鍒楄�?|
+| `get_financial_data` | `cik: str`, `period: str` | 鑾峰彇鐗瑰畾鏈熼棿璐㈠姟鏁版�?|
+| `extract_financial_metrics` | `cik: str`, `years?: int` (榛樿�?) | 鎻愬彇澶氬勾璐㈠姟鎸囨爣 |
+| `get_latest_financial_data` | `cik: str` | 鑾峰彇鏈€鏂拌储鍔℃暟鎹?|
+| `advanced_search_company` | `company_input: str` | 楂樼骇鎼滅储锛堟敮鎸佸叕鍙稿�?CIK�?|
+
+---
+
+## 馃�?娴嬭瘯绔�偣
+
+### 浣跨�?curl 娴嬭瘯锛?
+
+```bash
+# 娴嬭瘯绔�偣鏄�惁鍙�敤
+curl https://jc321-easyreportdatamcp.hf.space/mcp
+
+# 鍒楀嚭宸ュ叿
+curl -X POST https://jc321-easyreportdatamcp.hf.space/mcp \
+  -H "Content-Type: application/json" \
+  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'
+
+# 璋冪敤宸ュ叿
+curl -X POST https://jc321-easyreportdatamcp.hf.space/mcp \
+  -H "Content-Type: application/json" \
+  -d '{
+    "jsonrpc":"2.0",
+    "method":"tools/call",
+    "params":{
+      "name":"search_company",
+      "arguments":{"company_name":"Tesla"}
+    },
+    "id":2
+  }'
+```
+
+---
+
+## 鈿狅�?閲嶈�璇存槑
+
+### 1. **涓嶆�?stdio 妯″紡**
+褰撳墠鏈嶅姟鍣ㄩ儴缃插湪 HF Space 涓婏�?*涓嶆敮鎸?stdio 浼犺�?*锛屽彧鏀�寔 HTTP/SSE�?
+
+�?**涓嶈�浣跨敤**:
+```json
+{
+  "command": "python",
+  "args": ["path/to/mcp_server.py"]
+}
+```
+
+�?**搴旇�浣跨敤**:
+```json
+{
+  "url": "https://jc321-easyreportdatamcp.hf.space/mcp",
+  "transport": "http"
+}
+```
+
+### 2. **Gradio SDK 闄愬�?*
+- 鏈嶅姟鍣ㄤ娇�?Gradio SDK 杩愯�?
+- MCP 绔�偣閫氳繃 FastAPI 鎸傝浇鍦?Gradio 涔嬩�?
+- 绔�偣璺�緞: `/mcp` �?`/sse` 锛堜袱鑰呯瓑鏁堬�?
+
+### 3. **CIK 鏍煎�?*
+- CIK 闇€�?10 浣嶆暟瀛楁牸寮忥紝渚嬪�? `0001318605`
+- 鎼滅储鍏�徃鍚嶆椂浼氳嚜鍔ㄨ繑鍥炴�纭�牸寮忕殑 CIK
+
+---
+
+## 馃摓 璋冭瘯鎶€宸?
+
+### 濡傛灉瀹㈡埛绔�姤 404 閿欒�锛?
+
+1. **妫€�?URL 鏄�惁姝ｇ�?*:
+   - �?`https://jc321-easyreportdatamcp.hf.space/mcp`
+   - �?`https://jc321-easyreportdatamcp.hf.space/sse`
+   - �?`https://jc321-easyreportdatamcp.hf.space` (缂哄皯绔�偣璺��?
+
+2. **妫€鏌ヤ紶杈撶被�?*:
+   - 灏濊�?`"transport": "http"` 鑰屼笉鏄?`"transport": "sse"`
+   - 鎴栬€呭皾璇?`"transport": "sse"`
+
+3. **妫€鏌ュ�鎴风� MCP 鐗堟�?*:
+   - 鏈嶅姟鍣ㄤ娇�?MCP 鍗忚�?2024-11-05 鐗堟�?
+   - 纭�繚瀹㈡埛绔�敮�?JSON-RPC 2.0
+
+### 濡傛灉宸ュ叿璋冪敤澶辫触�?
+
+1. **妫€鏌ュ弬鏁版牸�?*:
+   ```json
+   {
+     "params": {
+       "name": "search_company",
+       "arguments": {
+         "company_name": "Tesla"  // 娉ㄦ剰鍙傛暟鍚嶅繀椤诲畬鍏ㄥ尮�?
+       }
+     }
+   }
+   ```
+
+2. **鏌ョ湅杩斿洖鐨勯敊璇�俊�?*:
+   - 鏈嶅姟鍣ㄤ細杩斿洖璇︾粏鐨勯敊璇�弿�?
+   - 妫€�?`result.content[0].text` 涓�殑閿欒�淇℃�?
+
+---
+
+## 馃幆 閰嶇疆妯℃澘锛堝�鍒跺嵆鐢��?
+
+### Claude Desktop 閰嶇�?
+
+浣嶇�? `%APPDATA%\Claude\claude_desktop_config.json` (Windows)
+
+```json
+{
+  "mcpServers": {
+    "sec-financial-data": {
+      "url": "https://jc321-easyreportdatamcp.hf.space/mcp",
+      "transport": "http"
+    }
+  }
+}
+```
+
+### Cursor IDE 閰嶇�?
+
+�?MCP 璁剧疆涓�坊鍔狅�?
+
+```json
+{
+  "mcpServers": {
+    "sec-financial-data": {
+      "url": "https://jc321-easyreportdatamcp.hf.space/mcp",
+      "transport": "http"
+    }
+  }
+}
+```
+
+---
+
+## �?楠岃瘉娓呭崟
+
+- [ ] URL 鍖呭�?`/mcp` �?`/sse` 绔�偣璺�緞
+- [ ] 浣跨�?`"transport": "http"` �?`"transport": "sse"`
+- [ ] 涓嶈�浣跨敤 `"command"` �?`"args"` (閭ｆ�?stdio 妯″紡)
+- [ ] 纭�繚瀹㈡埛绔�敮�?JSON-RPC 2.0
+- [ ] CIK 鍙傛暟浣跨敤 10 浣嶆暟瀛楁牸寮?
+
+---
+
+**鏈€鍚庢洿鏂?*: 2025-11-29  
+**鏈嶅姟鍣ㄧ増�?*: Gradio + FastAPI + FastMCP  
+**鍗忚�?*: MCP 2024-11-05 (JSON-RPC 2.0)

README.md

@@ -49,7 +49,7 @@ license: mit
 {
   "mcpServers": {
     "sec-financial-data": {
-      "url": "https://jc321-easyreportdatemcp.hf.space/sse",
+      "url": "https://jc321-easyreportdatamcp.hf.space/sse",
       "transport": "sse"
     }
   }