binance-futures-mcp 1.0.0__py3-none-any.whl → 1.0.2__py3-none-any.whl

{binance_futures_mcp-1.0.0.dist-info → binance_futures_mcp-1.0.2.dist-info}/METADATA

@@ -1,13 +1,12 @@
 Metadata-Version: 2.4
 Name: binance-futures-mcp
-Version: 1.0.0
+Version: 1.0.2
 Summary: A Model Context Protocol server for Binance Futures API
+Home-page: https://github.com/alexcandrabersiva/bin-mcp
 Author: Binance MCP Server
-License: MIT
-Project-URL: Homepage, https://github.com/bin-mcp/binance-mcp-server
-Project-URL: Repository, https://github.com/bin-mcp/binance-mcp-server.git
-Project-URL: Issues, https://github.com/bin-mcp/binance-mcp-server/issues
-Keywords: mcp,binance,trading,futures,api,model-context-protocol
+Project-URL: Bug Tracker, https://github.com/alexcandrabersiva/bin-mcp/issues
+Project-URL: Repository, https://github.com/alexcandrabersiva/bin-mcp.git
+Keywords: mcp binance trading futures api model-context-protocol
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
@@ -24,18 +23,46 @@ License-File: LICENSE
 Requires-Dist: mcp>=1.0.0
 Requires-Dist: aiohttp>=3.8.0
 Requires-Dist: pydantic>=2.0.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
-Requires-Dist: black>=23.0.0; extra == "dev"
-Requires-Dist: mypy>=1.0.0; extra == "dev"
-Requires-Dist: ruff>=0.1.0; extra == "dev"
+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
 
 # Binance MCP Server
 
 A Model Context Protocol (MCP) server that provides comprehensive access to Binance Futures API endpoints. This server implements all major trading, account management, and market data functionality as documented in the Binance Futures API.
 
+## Quick Start
+
+1. **Install the package:**
+   ```bash
+   pip install binance-futures-mcp
+   ```
+
+2. **Run the server:**
+   ```bash
+   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"]
+       }
+     }
+   }
+   ```
+
 ## Features
 
 ### Account Information Tools
@@ -69,26 +96,17 @@ A Model Context Protocol (MCP) server that provides comprehensive access to Bina
 
 ## Installation
 
-### Prerequisites
-- Python 3.8 or higher
-- Binance Futures API credentials
-
-### Method 1: Install via uvx (Recommended)
-
 ```bash
-uvx --from git+https://github.com/alexcandrabersiva/bin-mcp binance-mcp-server
+pip install binance-futures-mcp
 ```
 
-### Method 2: Local Installation
-
-```bash
-cd binance-mcp-server
-pip install -e .
-```
+### Development Installation
 
-Or install development dependencies:
+For development, you can install from source:
 
 ```bash
+git clone https://github.com/bin-mcp/binance-mcp-server.git
+cd binance-mcp-server
 pip install -e ".[dev]"
 ```
 
@@ -105,11 +123,8 @@ Add to your VS Code `settings.json`:
   "mcp.servers": {
     "binance": {
       "command": "uvx",
-      "args": ["binance-mcp-server"],
-      "env": {
-        "BINANCE_API_KEY": "your_api_key_here",
-        "BINANCE_SECRET_KEY": "your_secret_key_here"
-      }
+      "args": ["binance-futures-mcp", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"],
+      "env": {}
     }
   }
 }
@@ -123,12 +138,9 @@ Add to your Cursor configuration file (`.cursor/mcp.json`):
 {
   "servers": {
     "binance": {
-      "command": "uvx",
-      "args": ["binance-mcp-server"],
-      "env": {
-        "BINANCE_API_KEY": "your_api_key_here",
-        "BINANCE_SECRET_KEY": "your_secret_key_here"
-      }
+      "command": "uvx", 
+      "args": ["binance-futures-mcp", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"],
+      "env": {}
     }
   }
 }
@@ -143,11 +155,8 @@ Add to your Windsurf configuration (`.windsurf/mcp.json`):
   "mcpServers": {
     "binance": {
       "command": "uvx",
-      "args": ["binance-mcp-server"],
-      "env": {
-        "BINANCE_API_KEY": "your_api_key_here",
-        "BINANCE_SECRET_KEY": "your_secret_key_here"
-      }
+      "args": ["binance-futures-mcp", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"],
+      "env": {}
     }
   }
 }
@@ -165,11 +174,8 @@ Add to your Claude Desktop configuration file:
   "mcpServers": {
     "binance": {
       "command": "uvx",
-      "args": ["binance-mcp-server"],
-      "env": {
-        "BINANCE_API_KEY": "your_api_key_here",
-        "BINANCE_SECRET_KEY": "your_secret_key_here"
-      }
+      "args": ["binance-futures-mcp", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"],
+      "env": {}
     }
   }
 }
@@ -179,42 +185,25 @@ Add to your Claude Desktop configuration file:
 
 1. **No path needed**: With PyPI installation, you don't need to specify paths or working directories.
 
-2. **Set API credentials**: Replace `your_api_key_here` and `your_secret_key_here` with your actual Binance API credentials.
+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-mcp-server && python -m binance_mcp`
-   - `binance-mcp-server` (if installed globally)
+   - `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.
 
 5. **Security**: For production use, consider storing credentials in your system's environment variables instead of directly in configuration files.
 
-## Installation
-
-### Prerequisites
-- Python 3.8 or higher
-- Binance Futures API credentials
-
-### Method 1: Install via uvx (Recommended)
-
-```bash
-uvx --from git+https://github.com/alexcandrabersiva/bin-mcp binance-mcp-server
-```
-
-### Method 2: Local Installation
-
-```bash
-cd binance-mcp-server
-pip install -e .
-```
+## Configuration
 
-Or install development dependencies:
+### API Requirements
 
-```bash
-pip install -e ".[dev]"
-```
+Your Binance API key needs the following permissions:
+- **Futures Trading**: For order placement and management
+- **Futures Reading**: For account and market data access
 
-## Configuration
+**Note**: Market data endpoints (exchange info, prices, order books, etc.) work without authentication.
 
 ### Environment Variables
 
@@ -225,24 +214,19 @@ export BINANCE_API_KEY="your_api_key_here"
 export BINANCE_SECRET_KEY="your_secret_key_here"
 ```
 
-### API Permissions
-
-Your Binance API key needs the following permissions:
-- **Futures Trading**: For order placement and management
-- **Futures Reading**: For account and market data access
-
-**Note**: Market data endpoints (exchange info, prices, order books, etc.) work without authentication.
-
 ## Usage
 
 ### Running the Server
 
 ```bash
-# Run directly
+# Run directly (after installing from PyPI)
 python -m binance_mcp
 
-# Or using the installed script
-binance-mcp-server
+# Or using uvx (no installation needed)
+uvx binance-futures-mcp
+
+# With API credentials as arguments
+uvx binance-futures-mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
 ```
 
 ### Available Tools

binance_futures_mcp-1.0.2.dist-info/RECORD

@@ -0,0 +1,9 @@
+binance_futures_mcp-1.0.2.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=FZt8rs22u-37xeZg5Rg7uMVYsNDLZt99DG8EG5YN-k8,38270
+binance_futures_mcp-1.0.2.dist-info/METADATA,sha256=bUTTzWuLNtsHdDt4K2F3sFEhDt-rHU5zKF6y3UQ_ORc,11022
+binance_futures_mcp-1.0.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+binance_futures_mcp-1.0.2.dist-info/entry_points.txt,sha256=-1iVs9AF7JQBS-xMichP9hQhbCY7YfLFRJVaNKwuN34,69
+binance_futures_mcp-1.0.2.dist-info/top_level.txt,sha256=RqGhe1caZUvBF_ezvTiLZD8kVS25eiWVkfJfmoND9m8,12
+binance_futures_mcp-1.0.2.dist-info/RECORD,,

binance_futures_mcp-1.0.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+binance-mcp-server = binance_mcp.__main__:cli_main

binance_mcp/__main__.py

@@ -1,7 +1,13 @@
 #!/usr/bin/env python3
 
+import asyncio
 from binance_mcp.server import main
 
-if __name__ == "__main__":
-    import asyncio
+
+def cli_main():
+    """Entry point for the command-line interface"""
     asyncio.run(main())
+
+
+if __name__ == "__main__":
+    cli_main()

binance_mcp/server.py

@@ -750,8 +750,10 @@ async def main():
             write_stream, 
             InitializationOptions(
                 server_name="binance-futures-mcp-server",
-                server_version="1.0.0",
-                capabilities={}
+                server_version="1.0.1",
+                capabilities={
+                    "tools": {}
+                }
             )
         )
 

binance_futures_mcp-1.0.0.dist-info/RECORD

@@ -1,9 +0,0 @@
-binance_futures_mcp-1.0.0.dist-info/licenses/LICENSE,sha256=zqfwopvOi7kOx5YVOnehgmRFR-IU3x1n9JEShr3QOYg,1075
-binance_mcp/__init__.py,sha256=ExUxc1kp3GoSwmEtC7eGgFMZlvSQ4IdW1T5xhw-NT98,106
-binance_mcp/__main__.py,sha256=arjH5cad7koMZTvXR3u3eLE6I7pdT1zg5ttp7KNjQ6Y,131
-binance_mcp/server.py,sha256=LW16OetihWrkBLC1X-0Wg6k_Oug6PQ3LRVPkpEa32s0,38221
-binance_futures_mcp-1.0.0.dist-info/METADATA,sha256=_rOapSOSDn8prUvEifrTocZ4wEMNJm0TJXql2YTkXFk,11017
-binance_futures_mcp-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-binance_futures_mcp-1.0.0.dist-info/entry_points.txt,sha256=Olf_ctXC2kgUJEg-bfsy90EXuCDM0gW8xJwO_QzraqE,65
-binance_futures_mcp-1.0.0.dist-info/top_level.txt,sha256=RqGhe1caZUvBF_ezvTiLZD8kVS25eiWVkfJfmoND9m8,12
-binance_futures_mcp-1.0.0.dist-info/RECORD,,

binance_futures_mcp-1.0.0.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-binance-mcp-server = binance_mcp.__main__:main