futu-stock-mcp-server 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

futu_stock_mcp_server/server.py

@@ -42,13 +42,20 @@ logger.add(
     format="{time:YYYY-MM-DD HH:mm:ss} | {level} | {message}"
 )
 
-# Add console handler
+# Add console handler - output to stderr to avoid polluting MCP JSON communication
 logger.add(
-    lambda msg: print(msg),
+    sys.stderr,
     level="INFO",
-    format="{time:YYYY-MM-DD HH:mm:ss} | {level} | {message}"
+    format="{time:YYYY-MM-DD HH:mm:ss} | {level} | {message}",
+    colorize=False  # Disable colors to avoid ANSI escape sequences
 )
 
+# Suppress other library logs that might interfere with MCP communication
+import logging
+logging.getLogger().setLevel(logging.WARNING)  # Suppress INFO logs from other libraries
+logging.getLogger("mcp").setLevel(logging.WARNING)  # Suppress MCP internal logs
+logging.getLogger("futu").setLevel(logging.WARNING)  # Suppress Futu API logs
+
 logger.info(f"Starting server with log directory: {log_dir}")
 
 # PID file path
@@ -167,15 +174,24 @@ def signal_handler(signum, frame):
     """Handle process signals"""
     global _is_shutting_down
     if _is_shutting_down:
-        return
+        logger.info("Already shutting down, forcing exit...")
+        os._exit(1)
         
     # 只处理 SIGINT 和 SIGTERM
     if signum not in (signal.SIGINT, signal.SIGTERM):
         return
         
     logger.info(f"Received signal {signum}, cleaning up...")
-    cleanup_all()
-    sys.exit(0)
+    _is_shutting_down = True
+
+    try:
+        cleanup_all()
+        logger.info("Cleanup completed, exiting...")
+    except Exception as e:
+        logger.error(f"Error during cleanup: {e}")
+    finally:
+        # 强制退出，确保进程能够终止
+        os._exit(0)
 
 # Register cleanup functions
 atexit.register(cleanup_all)
@@ -1438,8 +1454,13 @@ async def get_current_time() -> Dict[str, Any]:
         'timezone': datetime.now().astimezone().tzname()
     }
 
-if __name__ == "__main__":
+def main():
+    """Main entry point for the futu-mcp-server command."""
     try:
+        # Ensure no color output in MCP mode
+        os.environ['NO_COLOR'] = '1'
+        os.environ['TERM'] = 'dumb'
+
         # 清理旧的进程和文件
         cleanup_stale_processes()
         
@@ -1457,19 +1478,25 @@ if __name__ == "__main__":
         if init_futu_connection():
             logger.info("Successfully initialized Futu connection")
             logger.info("Starting MCP server in stdio mode...")
+            logger.info("Press Ctrl+C to stop the server")
             try:
                 mcp.run(transport='stdio')
             except KeyboardInterrupt:
                 logger.info("Received keyboard interrupt, shutting down...")
-                sys.exit(0)
+                cleanup_all()
+                os._exit(0)
             except Exception as e:
                 logger.error(f"Error running server: {str(e)}")
-                sys.exit(1)
+                cleanup_all()
+                os._exit(1)
         else:
             logger.error("Failed to initialize Futu connection. Server will not start.")
-            sys.exit(1)
+            os._exit(1)
     except Exception as e:
         logger.error(f"Error starting server: {str(e)}")
         sys.exit(1)
     finally:
-        cleanup_all() 
+        cleanup_all() 
+
+if __name__ == "__main__":
+    main()

{futu_stock_mcp_server-0.1.0.dist-info → futu_stock_mcp_server-0.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: futu-stock-mcp-server
-Version: 0.1.0
+Version: 0.1.2
 Summary: A Model Context Protocol (MCP) server for accessing Futu OpenAPI functionality
 Project-URL: Homepage, https://github.com/shuizhengqi1/futu-stock-mcp-server
 Project-URL: Documentation, https://github.com/shuizhengqi1/futu-stock-mcp-server#readme
@@ -40,6 +40,8 @@ Requires-Dist: pytest-asyncio; extra == 'dev'
 Requires-Dist: ruff; extra == 'dev'
 Description-Content-Type: text/markdown
 
+[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/shuizhengqi1-futu-stocp-mcp-server-badge.png)](https://mseep.ai/app/shuizhengqi1-futu-stocp-mcp-server)
+
 # Futu Stock MCP Server
 
 [![Python Version](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org)
@@ -101,16 +103,25 @@ Description-Content-Type: text/markdown
 
 ## 🚀 快速开始
 
-### 方式一：通过 PyPI 安装（推荐）
+### 方式一：通过 pipx 安装（推荐）
 
 ```bash
+# 安装 pipx（如果还没有安装）
+brew install pipx  # macOS
+# 或者 pip install --user pipx  # 其他系统
+
 # 安装包
-pip install futu-stock-mcp-server
+pipx install futu-stock-mcp-server
 
 # 运行服务器
 futu-mcp-server
 ```
 
+> **为什么使用 pipx？**
+> - pipx 专门用于安装 Python 应用程序到全局环境
+> - 自动管理独立的虚拟环境，避免依赖冲突
+> - 命令直接可用，无需激活虚拟环境
+
 ### 方式二：通过 Docker 运行
 
 ```bash
@@ -216,22 +227,61 @@ Run formatting:
 ruff format .
 ```
 
-## Usage
+## 🔧 MCP Server 配置
 
-1. Start the server:
-```bash
-python -m futu_stock_mcp_server.server
+### 在 Claude Desktop 中配置
+
+1. **找到配置文件位置**：
+   - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+   - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+2. **添加服务器配置**：
+```json
+{
+  "mcpServers": {
+    "futu-stock": {
+      "command": "futu-mcp-server",
+      "env": {
+        "FUTU_HOST": "127.0.0.1",
+        "FUTU_PORT": "11111"
+      }
+    }
+  }
+}
+```
+
+3. **故障排除配置**：
+如果上述配置不工作，可以尝试使用完整路径：
+```json
+{
+  "mcpServers": {
+    "futu-stock": {
+      "command": "/Users/your-username/.local/bin/futu-mcp-server",
+      "env": {
+        "FUTU_HOST": "127.0.0.1",
+        "FUTU_PORT": "11111"
+      }
+    }
+  }
+}
 ```
 
-2. Connect to the server using an MCP client:
+> **提示**：使用 `which futu-mcp-server` 命令查看完整路径
+
+### 在其他 MCP 客户端中配置
+
+#### 使用 Python MCP 客户端
 ```python
 from mcp import ClientSession, StdioServerParameters
 from mcp.client.stdio import stdio_client
 
 async def main():
     server_params = StdioServerParameters(
-        command="python",
-        args=["src/server.py"]
+        command="futu-mcp-server",
+        env={
+            "FUTU_HOST": "127.0.0.1",
+            "FUTU_PORT": "11111"
+        }
     )
     
     async with stdio_client(server_params) as (read, write):
@@ -241,7 +291,123 @@ async def main():
             
             # List available tools
             tools = await session.list_tools()
+            print("Available tools:", [tool.name for tool in tools.tools])
+```
             
+#### 使用 Node.js MCP 客户端
+```javascript
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+
+const transport = new StdioClientTransport({
+  command: "futu-mcp-server",
+  env: {
+    FUTU_HOST: "127.0.0.1",
+    FUTU_PORT: "11111"
+  }
+});
+
+const client = new Client({
+  name: "futu-stock-client",
+  version: "1.0.0"
+}, {
+  capabilities: {}
+});
+
+await client.connect(transport);
+```
+
+## 📋 使用方法
+
+### 1. 启动服务器（独立运行）
+```bash
+# 通过 pip 安装后
+futu-mcp-server
+
+# 或从源码运行
+python -m futu_stock_mcp_server.server
+```
+
+### 2. 环境变量配置
+创建 `.env` 文件或设置环境变量：
+```bash
+FUTU_HOST=127.0.0.1
+FUTU_PORT=11111
+LOG_LEVEL=INFO
+```
+
+### 3. 验证连接
+启动服务器后，你应该看到类似的日志：
+```
+2024-10-02 14:20:52 | INFO | Initializing Futu connection...
+2024-10-02 14:20:52 | INFO | Successfully initialized Futu connection
+2024-10-02 14:20:52 | INFO | Starting MCP server in stdio mode...
+2024-10-02 14:20:52 | INFO | Press Ctrl+C to stop the server
+```
+
+### 4. 在 AI 工具中使用
+配置完成后，重启 Claude Desktop 或其他 MCP 客户端，你就可以：
+- 查询股票实时行情
+- 获取历史K线数据
+- 订阅股票数据推送
+- 查询账户信息
+- 执行交易操作（需要交易权限）
+
+## 🔧 故障排除
+
+### 常见问题
+
+#### 1. 命令 `futu-mcp-server` 找不到
+```bash
+# 确保已正确安装
+pipx install futu-stock-mcp-server
+
+# 检查命令是否可用
+which futu-mcp-server
+
+# 如果还是找不到，检查 PATH
+echo $PATH | grep -o '[^:]*\.local/bin[^:]*'
+```
+
+#### 2. Ctrl+C 无法退出服务器
+- 新版本已修复此问题
+- 如果仍然遇到，可以使用 `kill -9 <pid>` 强制终止
+
+#### 3. 连接富途 OpenD 失败
+```bash
+# 检查 OpenD 是否运行
+netstat -an | grep 11111
+
+# 检查环境变量
+echo $FUTU_HOST
+echo $FUTU_PORT
+```
+
+#### 4. Claude Desktop 无法识别服务器
+- 确保配置文件路径正确
+- 检查 JSON 格式是否有效
+- 重启 Claude Desktop
+- 查看 Claude Desktop 的日志文件
+
+#### 5. 权限问题
+```bash
+# 确保有执行权限
+chmod +x ~/.local/bin/futu-mcp-server
+
+# 或者使用完整路径
+python -m futu_stock_mcp_server.server
+```
+
+### 日志调试
+启用详细日志：
+```bash
+export LOG_LEVEL=DEBUG
+futu-mcp-server
+```
+
+日志文件位置：`./logs/futu_server.log`
+            tools = await session.list_tools()
+
             # Call a tool
             result = await session.call_tool(
                 "get_stock_quote",

futu_stock_mcp_server-0.1.2.dist-info/RECORD

@@ -0,0 +1,7 @@
+futu_stock_mcp_server/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+futu_stock_mcp_server/server.py,sha256=xFtYbURXhj0DOkbCFgwHDKHCAATWlSxdBZudrWsodVc,52810
+futu_stock_mcp_server-0.1.2.dist-info/METADATA,sha256=CmSaX6UUSExUdbci62zSZER2udDlV6Fqfqd3SSYHSlg,20453
+futu_stock_mcp_server-0.1.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+futu_stock_mcp_server-0.1.2.dist-info/entry_points.txt,sha256=GAdKqPJD9dJ_fRA3e3m0NRia0elN5OcjEeAI30vOcIM,70
+futu_stock_mcp_server-0.1.2.dist-info/licenses/LICENSE,sha256=XQBSQkjjpkymu_uLdyis4oNynV60VH1X7nS16uwM6g0,1069
+futu_stock_mcp_server-0.1.2.dist-info/RECORD,,

{futu_stock_mcp_server-0.1.0.dist-info → futu_stock_mcp_server-0.1.2.dist-info}/licenses/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Futu Stock MCP Server
+Copyright (c) 2024 yanghengxing
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

futu_stock_mcp_server-0.1.0.dist-info/RECORD

@@ -1,7 +0,0 @@
-futu_stock_mcp_server/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-futu_stock_mcp_server/server.py,sha256=UcP4esdCD2BlPhsdok0OrhBu_ipGnTaI1VUtGAI_-pY,51723
-futu_stock_mcp_server-0.1.0.dist-info/METADATA,sha256=QEbY7SIHGOZzsKTzQmayzDkvXd2VkhTrELHKsxT5KT4,16529
-futu_stock_mcp_server-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-futu_stock_mcp_server-0.1.0.dist-info/entry_points.txt,sha256=GAdKqPJD9dJ_fRA3e3m0NRia0elN5OcjEeAI30vOcIM,70
-futu_stock_mcp_server-0.1.0.dist-info/licenses/LICENSE,sha256=0sCjXbZOqpxlrCLnRTr9M9mNvvltzqUqzyK8d42nMN0,1078
-futu_stock_mcp_server-0.1.0.dist-info/RECORD,,