binance-futures-mcp 1.0.3__py3-none-any.whl → 1.0.6__py3-none-any.whl

{binance_futures_mcp-1.0.3.dist-info → binance_futures_mcp-1.0.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.1
 Name: binance-futures-mcp
-Version: 1.0.3
+Version: 1.0.6
 Summary: A Model Context Protocol server for Binance Futures API
 Home-page: https://github.com/alexcandrabersiva/bin-mcp
 Author: Binance MCP Server
@@ -20,20 +20,9 @@ Classifier: Topic :: Office/Business :: Financial :: Investment
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: mcp>=1.0.0
-Requires-Dist: aiohttp>=3.8.0
-Requires-Dist: pydantic>=2.0.0
-Dynamic: author
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license-file
-Dynamic: project-url
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
+Requires-Dist: mcp (>=1.0.0)
+Requires-Dist: aiohttp (>=3.8.0)
+Requires-Dist: pydantic (>=2.0.0)
 
 # Binance MCP Server
 
@@ -54,10 +43,12 @@ A Model Context Protocol (MCP) server that provides comprehensive access to Bina
 3. **Or configure in VS Code** by adding to your `settings.json`:
    ```json
    {
-     "mcp.servers": {
-       "binance": {
-         "command": "uvx",
-         "args": ["binance-futures-mcp", "--binance-api-key", "your_key", "--binance-secret-key", "your_secret"]
+     "mcp": {
+       "servers": {
+         "binance": {
+           "command": "uvx",
+           "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_key", "--binance-secret-key", "your_secret"]
+         }
        }
      }
    }
@@ -120,11 +111,12 @@ Add to your VS Code `settings.json`:
 
 ```json
 {
-  "mcp.servers": {
-    "binance": {
-      "command": "uvx",
-      "args": ["binance-futures-mcp", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"],
-      "env": {}
+  "mcp": {
+    "servers": {
+      "binance": {
+        "command": "uvx",
+        "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
+      }
     }
   }
 }
@@ -139,8 +131,7 @@ Add to your Cursor configuration file (`.cursor/mcp.json`):
   "servers": {
     "binance": {
       "command": "uvx", 
-      "args": ["binance-futures-mcp", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"],
-      "env": {}
+      "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
     }
   }
 }
@@ -155,8 +146,7 @@ Add to your Windsurf configuration (`.windsurf/mcp.json`):
   "mcpServers": {
     "binance": {
       "command": "uvx",
-      "args": ["binance-futures-mcp", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"],
-      "env": {}
+      "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
     }
   }
 }
@@ -174,8 +164,7 @@ Add to your Claude Desktop configuration file:
   "mcpServers": {
     "binance": {
       "command": "uvx",
-      "args": ["binance-futures-mcp", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"],
-      "env": {}
+      "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
     }
   }
 }
@@ -187,9 +176,10 @@ Add to your Claude Desktop configuration file:
 
 2. **Set API credentials**: Replace `your_api_key` and `your_secret_key` with your actual Binance API credentials.
 
-3. **Alternative commands**: You can also use:
+2. **Alternative commands**: You can also use:
+   - `uvx binance-futures-mcp` (direct package execution)
+   - `uvx --from binance-futures-mcp binance-mcp-server.exe` (explicit executable)
    - `pip install binance-futures-mcp && python -m binance_mcp`
-   - `binance-mcp-server` (if installed globally and on PATH)
 
 4. **Python environment**: Using `uvx` automatically handles the Python environment.
 
@@ -231,7 +221,7 @@ uvx binance-futures-mcp --binance-api-key "your_key" --binance-secret-key "your_
 
 ### Available Tools
 
-The server provides 32 tools organized into categories:
+The server provides 37 tools organized into categories:
 
 #### Account Information (5 tools)
 - `get_account_info` - Get futures account information
@@ -264,10 +254,12 @@ The server provides 32 tools organized into categories:
 - `change_position_mode` - Change position mode
 - `modify_position_margin` - Modify position margin
 
-#### Market Data (6 tools)
+#### Market Data (8 tools)
 - `get_exchange_info` - Get trading rules and symbol info
 - `get_book_ticker` - Get best bid/ask prices
 - `get_price_ticker` - Get latest prices
+- `get_24hr_ticker` - Get 24hr price change statistics
+- `get_taker_buy_sell_volume` - Get taker buy/sell volume ratio
 - `get_order_book` - Get order book depth
 - `get_klines` - Get candlestick data
 - `get_mark_price` - Get mark price and funding rate
@@ -332,6 +324,28 @@ The server provides 32 tools organized into categories:
 }
 ```
 
+### Get 24hr Price Statistics
+
+```json
+{
+  "tool": "get_24hr_ticker",
+  "arguments": {
+    "symbol": "BTCUSDT"
+  }
+}
+```
+
+### Get Taker Buy/Sell Volume Ratio
+
+```json
+{
+  "tool": "get_taker_buy_sell_volume",
+  "arguments": {
+    "symbol": "BTCUSDT"
+  }
+}
+```
+
 ## Security
 
 ### API Key Security

binance_futures_mcp-1.0.6.dist-info/RECORD

@@ -0,0 +1,9 @@
+binance_mcp/__init__.py,sha256=ExUxc1kp3GoSwmEtC7eGgFMZlvSQ4IdW1T5xhw-NT98,106
+binance_mcp/__main__.py,sha256=_9DBrtv0PAvjLjCqKk_cMfGtkqSUOcmU6HeQKFjuFMQ,214
+binance_mcp/server.py,sha256=phF-od_mUEusWHdWJhaXimxKF8SlS6NltlQNglRsy7U,41669
+binance_futures_mcp-1.0.6.dist-info/LICENSE,sha256=zqfwopvOi7kOx5YVOnehgmRFR-IU3x1n9JEShr3QOYg,1075
+binance_futures_mcp-1.0.6.dist-info/METADATA,sha256=yQiqDxpSDb3ln5Tlbj4Zu-fV6w1dHxK151HZIvdlOyU,11417
+binance_futures_mcp-1.0.6.dist-info/WHEEL,sha256=pkctZYzUS4AYVn6dJ-7367OJZivF2e8RA9b_ZBjif18,92
+binance_futures_mcp-1.0.6.dist-info/entry_points.txt,sha256=-1iVs9AF7JQBS-xMichP9hQhbCY7YfLFRJVaNKwuN34,69
+binance_futures_mcp-1.0.6.dist-info/top_level.txt,sha256=RqGhe1caZUvBF_ezvTiLZD8kVS25eiWVkfJfmoND9m8,12
+binance_futures_mcp-1.0.6.dist-info/RECORD,,

{binance_futures_mcp-1.0.3.dist-info → binance_futures_mcp-1.0.6.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: bdist_wheel (0.40.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

binance_mcp/server.py

@@ -27,14 +27,31 @@ class BinanceConfig:
 
 
 class BinanceClient:
-    """Binance Futures API client"""
+    """Binance Futures API client with improved connectivity"""
     
     def __init__(self, config: BinanceConfig):
         self.config = config
         self.session: Optional[aiohttp.ClientSession] = None
     
     async def __aenter__(self):
-        self.session = aiohttp.ClientSession()
+        # Create session with better connectivity settings
+        timeout = aiohttp.ClientTimeout(total=30, connect=10)
+        connector = aiohttp.TCPConnector(
+            ttl_dns_cache=300,
+            use_dns_cache=True,
+            limit=100,
+            limit_per_host=10,
+            enable_cleanup_closed=True
+        )
+        
+        self.session = aiohttp.ClientSession(
+            timeout=timeout,
+            connector=connector,
+            headers={
+                'User-Agent': 'binance-mcp-server/1.0.6',
+                'Content-Type': 'application/x-www-form-urlencoded'
+            }
+        )
         return self
     
     async def __aexit__(self, exc_type, exc_val, exc_tb):
@@ -78,17 +95,24 @@ class BinanceClient:
         
         try:
             if method == "GET":
-                async with self.session.get(url, params=params, headers=headers) as response:
+                async with self.session.get(url, params=params, headers=headers, ssl=False) as response:
+                    response.raise_for_status()
                     return await response.json()
             elif method == "POST":
-                async with self.session.post(url, data=params, headers=headers) as response:
+                async with self.session.post(url, data=params, headers=headers, ssl=False) as response:
+                    response.raise_for_status()
                     return await response.json()
             elif method == "DELETE":
-                async with self.session.delete(url, data=params, headers=headers) as response:
+                async with self.session.delete(url, data=params, headers=headers, ssl=False) as response:
+                    response.raise_for_status()
                     return await response.json()
             else:
                 raise ValueError(f"Unsupported HTTP method: {method}")
                 
+        except aiohttp.ClientError as e:
+            raise Exception(f"Network error connecting to Binance API: {str(e)}")
+        except asyncio.TimeoutError:
+            raise Exception("Request timeout - please check your internet connection")
         except Exception as e:
             raise Exception(f"Request failed: {str(e)}")
 
@@ -448,6 +472,17 @@ class BinanceMCPServer:
                         "required": []
                     }
                 ),
+                Tool(
+                    name="get_24hr_ticker",
+                    description="Get 24hr ticker price change statistics",
+                    inputSchema={
+                        "type": "object",
+                        "properties": {
+                            "symbol": {"type": "string", "description": "Trading pair symbol (optional, if not provided returns all symbols)"}
+                        },
+                        "required": []
+                    }
+                ),
                 Tool(
                     name="get_order_book",
                     description="Get order book for a symbol",
@@ -515,6 +550,21 @@ class BinanceMCPServer:
                         "required": []
                     }
                 ),
+                Tool(
+                    name="get_taker_buy_sell_volume",
+                    description="Get taker buy/sell volume ratio statistics",
+                    inputSchema={
+                        "type": "object",
+                        "properties": {
+                            "symbol": {"type": "string", "description": "Trading pair symbol"},
+                            "period": {"type": "string", "description": "Period for the data (5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d)"},
+                            "start_time": {"type": "integer", "description": "Start timestamp in ms"},
+                            "end_time": {"type": "integer", "description": "End timestamp in ms"},
+                            "limit": {"type": "integer", "description": "Number of entries (max 500, default 30)"}
+                        },
+                        "required": ["symbol", "period"]
+                    }
+                ),
 
                 # Trading History Tools
                 Tool(
@@ -555,9 +605,9 @@ class BinanceMCPServer:
             
             # Check if API credentials are configured for authenticated endpoints
             unauthenticated_tools = [
-                "get_exchange_info", "get_price_ticker", "get_book_ticker", 
+                "get_exchange_info", "get_price_ticker", "get_24hr_ticker", "get_book_ticker", 
                 "get_order_book", "get_klines", "get_mark_price", 
-                "get_aggregate_trades", "get_funding_rate_history"
+                "get_aggregate_trades", "get_funding_rate_history", "get_taker_buy_sell_volume"
             ]
             
             if not self.config.api_key or not self.config.secret_key:
@@ -689,6 +739,11 @@ class BinanceMCPServer:
                         if "symbol" in arguments:
                             params["symbol"] = arguments["symbol"]
                         result = await client._make_request("GET", "/fapi/v1/ticker/price", params)
+                    elif name == "get_24hr_ticker":
+                        params = {}
+                        if "symbol" in arguments:
+                            params["symbol"] = arguments["symbol"]
+                        result = await client._make_request("GET", "/fapi/v1/ticker/24hr", params)
                     elif name == "get_order_book":
                         params = {
                             "symbol": arguments["symbol"],
@@ -709,6 +764,9 @@ class BinanceMCPServer:
                     elif name == "get_funding_rate_history":
                         params = {k: v for k, v in arguments.items() if v is not None}
                         result = await client._make_request("GET", "/fapi/v1/fundingRate", params)
+                    elif name == "get_taker_buy_sell_volume":
+                        params = {k: v for k, v in arguments.items() if v is not None}
+                        result = await client._make_request("GET", "/futures/data/takerlongshortRatio", params)
                     
                     # Trading History Tools
                     elif name == "get_account_trades":
@@ -758,7 +816,7 @@ async def main():
             write_stream, 
             InitializationOptions(
                 server_name="binance-futures-mcp-server",
-                server_version="1.0.1",
+                server_version="1.0.6",
                 capabilities={
                     "tools": {}
                 }

binance_futures_mcp-1.0.3.dist-info/RECORD

@@ -1,9 +0,0 @@
-binance_futures_mcp-1.0.3.dist-info/licenses/LICENSE,sha256=zqfwopvOi7kOx5YVOnehgmRFR-IU3x1n9JEShr3QOYg,1075
-binance_mcp/__init__.py,sha256=ExUxc1kp3GoSwmEtC7eGgFMZlvSQ4IdW1T5xhw-NT98,106
-binance_mcp/__main__.py,sha256=_9DBrtv0PAvjLjCqKk_cMfGtkqSUOcmU6HeQKFjuFMQ,214
-binance_mcp/server.py,sha256=aSlbwCFr5EV9X_vt70eK6-ACVkMl6IxNDkNA4yaRW1o,38583
-binance_futures_mcp-1.0.3.dist-info/METADATA,sha256=xXqrBUjb3_r22RJD9l6FWRjC__4ygDfjcwz3KlkXTXg,11022
-binance_futures_mcp-1.0.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-binance_futures_mcp-1.0.3.dist-info/entry_points.txt,sha256=-1iVs9AF7JQBS-xMichP9hQhbCY7YfLFRJVaNKwuN34,69
-binance_futures_mcp-1.0.3.dist-info/top_level.txt,sha256=RqGhe1caZUvBF_ezvTiLZD8kVS25eiWVkfJfmoND9m8,12
-binance_futures_mcp-1.0.3.dist-info/RECORD,,