futu-stock-mcp-server 0.1.1__tar.gz → 0.1.2__tar.gz

{futu_stock_mcp_server-0.1.1 → futu_stock_mcp_server-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: futu-stock-mcp-server
-Version: 0.1.1
+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
@@ -239,12 +250,13 @@ ruff format .
 }
 ```
 
-3. **如果使用虚拟环境或从源码运行**：
+3. **故障排除配置**：
+如果上述配置不工作，可以尝试使用完整路径：
 ```json
 {
   "mcpServers": {
     "futu-stock": {
-      "command": "/path/to/your/venv/bin/futu-mcp-server",
+      "command": "/Users/your-username/.local/bin/futu-mcp-server",
       "env": {
         "FUTU_HOST": "127.0.0.1",
         "FUTU_PORT": "11111"
@@ -254,22 +266,7 @@ ruff format .
 }
 ```
 
-或者使用 Python 模块方式：
-```json
-{
-  "mcpServers": {
-    "futu-stock": {
-      "command": "python",
-      "args": ["-m", "futu_stock_mcp_server.server"],
-      "cwd": "/path/to/futu-stock-mcp-server",
-      "env": {
-        "FUTU_HOST": "127.0.0.1",
-        "FUTU_PORT": "11111"
-      }
-    }
-  }
-}
-```
+> **提示**：使用 `which futu-mcp-server` 命令查看完整路径
 
 ### 在其他 MCP 客户端中配置
 
@@ -363,10 +360,13 @@ LOG_LEVEL=INFO
 #### 1. 命令 `futu-mcp-server` 找不到
 ```bash
 # 确保已正确安装
-pip install futu-stock-mcp-server
+pipx install futu-stock-mcp-server
 
-# 或者检查是否在虚拟环境中
+# 检查命令是否可用
 which futu-mcp-server
+
+# 如果还是找不到，检查 PATH
+echo $PATH | grep -o '[^:]*\.local/bin[^:]*'
 ```
 
 #### 2. Ctrl+C 无法退出服务器

{futu_stock_mcp_server-0.1.1 → futu_stock_mcp_server-0.1.2}/README.md

@@ -1,3 +1,5 @@
+[![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)
@@ -59,16 +61,25 @@
 
 ## 🚀 快速开始
 
-### 方式一：通过 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
@@ -197,12 +208,13 @@ ruff format .
 }
 ```
 
-3. **如果使用虚拟环境或从源码运行**：
+3. **故障排除配置**：
+如果上述配置不工作，可以尝试使用完整路径：
 ```json
 {
   "mcpServers": {
     "futu-stock": {
-      "command": "/path/to/your/venv/bin/futu-mcp-server",
+      "command": "/Users/your-username/.local/bin/futu-mcp-server",
       "env": {
         "FUTU_HOST": "127.0.0.1",
         "FUTU_PORT": "11111"
@@ -212,22 +224,7 @@ ruff format .
 }
 ```
 
-或者使用 Python 模块方式：
-```json
-{
-  "mcpServers": {
-    "futu-stock": {
-      "command": "python",
-      "args": ["-m", "futu_stock_mcp_server.server"],
-      "cwd": "/path/to/futu-stock-mcp-server",
-      "env": {
-        "FUTU_HOST": "127.0.0.1",
-        "FUTU_PORT": "11111"
-      }
-    }
-  }
-}
-```
+> **提示**：使用 `which futu-mcp-server` 命令查看完整路径
 
 ### 在其他 MCP 客户端中配置
 
@@ -321,10 +318,13 @@ LOG_LEVEL=INFO
 #### 1. 命令 `futu-mcp-server` 找不到
 ```bash
 # 确保已正确安装
-pip install futu-stock-mcp-server
+pipx install futu-stock-mcp-server
 
-# 或者检查是否在虚拟环境中
+# 检查命令是否可用
 which futu-mcp-server
+
+# 如果还是找不到，检查 PATH
+echo $PATH | grep -o '[^:]*\.local/bin[^:]*'
 ```
 
 #### 2. Ctrl+C 无法退出服务器

{futu_stock_mcp_server-0.1.1 → futu_stock_mcp_server-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "futu-stock-mcp-server"
-version = "0.1.1"
+version = "0.1.2"
 description = "A Model Context Protocol (MCP) server for accessing Futu OpenAPI functionality"
 readme = "README.md"
 license = {text = "MIT"}

{futu_stock_mcp_server-0.1.1 → futu_stock_mcp_server-0.1.2}/src/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
@@ -1450,6 +1457,10 @@ async def get_current_time() -> Dict[str, Any]:
 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()