binance-futures-mcp 1.0.4__py3-none-any.whl → 1.0.7__py3-none-any.whl

{binance_futures_mcp-1.0.4.dist-info → binance_futures_mcp-1.0.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.1
 Name: binance-futures-mcp
-Version: 1.0.4
+Version: 1.0.7
 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
 
@@ -43,21 +32,23 @@ A Model Context Protocol (MCP) server that provides comprehensive access to Bina
 
 1. **Install the package:**
    ```bash
-   pip install binance-futures-mcp
+   pip install binance_futures_mcp
    ```
 
 2. **Run the server:**
    ```bash
-   uvx binance-futures-mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
+   uvx binance_futures_mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
    ```
 
 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"]
+         }
        }
      }
    }
@@ -97,7 +88,7 @@ A Model Context Protocol (MCP) server that provides comprehensive access to Bina
 ## Installation
 
 ```bash
-pip install binance-futures-mcp
+pip install binance_futures_mcp
 ```
 
 ### Development Installation
@@ -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:
-   - `pip install binance-futures-mcp && python -m binance_mcp`
-   - `binance-mcp-server` (if installed globally and on PATH)
+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`
 
 4. **Python environment**: Using `uvx` automatically handles the Python environment.
 
@@ -223,15 +213,15 @@ export BINANCE_SECRET_KEY="your_secret_key_here"
 python -m binance_mcp
 
 # Or using uvx (no installation needed)
-uvx binance-futures-mcp
+uvx binance_futures_mcp
 
 # With API credentials as arguments
-uvx binance-futures-mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
+uvx binance_futures_mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
 ```
 
 ### Available Tools
 
-The server provides 32 tools organized into categories:
+The server provides 35 tools organized into categories:
 
 #### Account Information (5 tools)
 - `get_account_info` - Get futures account information
@@ -264,19 +254,21 @@ 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 (10 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
 - `get_aggregate_trades` - Get aggregate trade data
+- `get_funding_rate_history` - Get funding rate history
 
-#### Trading History (3 tools)
+#### Trading History (2 tools)
 - `get_account_trades` - Get account trade history
 - `get_income_history` - Get income history
-- `get_funding_rate_history` - Get funding rate history
 
 ## Example Usage
 
@@ -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.7.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=mBuB1HX6xf5GSviYV5oIPqKz2werdBiibyxTUA-qnpY,41669
+binance_futures_mcp-1.0.7.dist-info/LICENSE,sha256=zqfwopvOi7kOx5YVOnehgmRFR-IU3x1n9JEShr3QOYg,1075
+binance_futures_mcp-1.0.7.dist-info/METADATA,sha256=GgB3I-rPgq5YKmV9Usi-RYvAtpQ9rk7LowADz1-Q5j8,11418
+binance_futures_mcp-1.0.7.dist-info/WHEEL,sha256=pkctZYzUS4AYVn6dJ-7367OJZivF2e8RA9b_ZBjif18,92
+binance_futures_mcp-1.0.7.dist-info/entry_points.txt,sha256=-1iVs9AF7JQBS-xMichP9hQhbCY7YfLFRJVaNKwuN34,69
+binance_futures_mcp-1.0.7.dist-info/top_level.txt,sha256=RqGhe1caZUvBF_ezvTiLZD8kVS25eiWVkfJfmoND9m8,12
+binance_futures_mcp-1.0.7.dist-info/RECORD,,

{binance_futures_mcp-1.0.4.dist-info → binance_futures_mcp-1.0.7.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

@@ -48,7 +48,7 @@ class BinanceClient:
             timeout=timeout,
             connector=connector,
             headers={
-                'User-Agent': 'binance-mcp-server/1.0.3',
+                'User-Agent': 'binance-mcp-server/1.0.7',
                 'Content-Type': 'application/x-www-form-urlencoded'
             }
         )
@@ -472,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",
@@ -539,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(
@@ -579,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:
@@ -713,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"],
@@ -733,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":
@@ -782,7 +816,7 @@ async def main():
             write_stream, 
             InitializationOptions(
                 server_name="binance-futures-mcp-server",
-                server_version="1.0.1",
+                server_version="1.0.7",
                 capabilities={
                     "tools": {}
                 }

binance_futures_mcp-1.0.4.dist-info/RECORD

@@ -1,9 +0,0 @@
-binance_futures_mcp-1.0.4.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=ApB26p9GyoEoJzc0AyZhDG_Z6BMq2i43irVgf88hoFw,39605
-binance_futures_mcp-1.0.4.dist-info/METADATA,sha256=uIvIKbrdj81WlYcXyRgxFsUd8ZyWEYPZ6-AvLHv0bVU,11022
-binance_futures_mcp-1.0.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-binance_futures_mcp-1.0.4.dist-info/entry_points.txt,sha256=-1iVs9AF7JQBS-xMichP9hQhbCY7YfLFRJVaNKwuN34,69
-binance_futures_mcp-1.0.4.dist-info/top_level.txt,sha256=RqGhe1caZUvBF_ezvTiLZD8kVS25eiWVkfJfmoND9m8,12
-binance_futures_mcp-1.0.4.dist-info/RECORD,,