binance-futures-mcp 1.0.0__tar.gz → 1.0.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,13 +1,12 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: binance-futures-mcp
3
- Version: 1.0.0
3
+ Version: 1.0.2
4
4
  Summary: A Model Context Protocol server for Binance Futures API
5
+ Home-page: https://github.com/alexcandrabersiva/bin-mcp
5
6
  Author: Binance MCP Server
6
- License: MIT
7
- Project-URL: Homepage, https://github.com/bin-mcp/binance-mcp-server
8
- Project-URL: Repository, https://github.com/bin-mcp/binance-mcp-server.git
9
- Project-URL: Issues, https://github.com/bin-mcp/binance-mcp-server/issues
10
- Keywords: mcp,binance,trading,futures,api,model-context-protocol
7
+ Project-URL: Bug Tracker, https://github.com/alexcandrabersiva/bin-mcp/issues
8
+ Project-URL: Repository, https://github.com/alexcandrabersiva/bin-mcp.git
9
+ Keywords: mcp binance trading futures api model-context-protocol
11
10
  Classifier: Development Status :: 4 - Beta
12
11
  Classifier: Intended Audience :: Developers
13
12
  Classifier: Programming Language :: Python :: 3
@@ -24,18 +23,46 @@ License-File: LICENSE
24
23
  Requires-Dist: mcp>=1.0.0
25
24
  Requires-Dist: aiohttp>=3.8.0
26
25
  Requires-Dist: pydantic>=2.0.0
27
- Provides-Extra: dev
28
- Requires-Dist: pytest>=7.0.0; extra == "dev"
29
- Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
30
- Requires-Dist: black>=23.0.0; extra == "dev"
31
- Requires-Dist: mypy>=1.0.0; extra == "dev"
32
- Requires-Dist: ruff>=0.1.0; extra == "dev"
26
+ Dynamic: author
27
+ Dynamic: classifier
28
+ Dynamic: description
29
+ Dynamic: description-content-type
30
+ Dynamic: home-page
31
+ Dynamic: keywords
33
32
  Dynamic: license-file
33
+ Dynamic: project-url
34
+ Dynamic: requires-dist
35
+ Dynamic: requires-python
36
+ Dynamic: summary
34
37
 
35
38
  # Binance MCP Server
36
39
 
37
40
  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.
38
41
 
42
+ ## Quick Start
43
+
44
+ 1. **Install the package:**
45
+ ```bash
46
+ pip install binance-futures-mcp
47
+ ```
48
+
49
+ 2. **Run the server:**
50
+ ```bash
51
+ uvx binance-futures-mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
52
+ ```
53
+
54
+ 3. **Or configure in VS Code** by adding to your `settings.json`:
55
+ ```json
56
+ {
57
+ "mcp.servers": {
58
+ "binance": {
59
+ "command": "uvx",
60
+ "args": ["binance-futures-mcp", "--binance-api-key", "your_key", "--binance-secret-key", "your_secret"]
61
+ }
62
+ }
63
+ }
64
+ ```
65
+
39
66
  ## Features
40
67
 
41
68
  ### Account Information Tools
@@ -69,26 +96,17 @@ A Model Context Protocol (MCP) server that provides comprehensive access to Bina
69
96
 
70
97
  ## Installation
71
98
 
72
- ### Prerequisites
73
- - Python 3.8 or higher
74
- - Binance Futures API credentials
75
-
76
- ### Method 1: Install via uvx (Recommended)
77
-
78
99
  ```bash
79
- uvx --from git+https://github.com/alexcandrabersiva/bin-mcp binance-mcp-server
100
+ pip install binance-futures-mcp
80
101
  ```
81
102
 
82
- ### Method 2: Local Installation
83
-
84
- ```bash
85
- cd binance-mcp-server
86
- pip install -e .
87
- ```
103
+ ### Development Installation
88
104
 
89
- Or install development dependencies:
105
+ For development, you can install from source:
90
106
 
91
107
  ```bash
108
+ git clone https://github.com/bin-mcp/binance-mcp-server.git
109
+ cd binance-mcp-server
92
110
  pip install -e ".[dev]"
93
111
  ```
94
112
 
@@ -105,11 +123,8 @@ Add to your VS Code `settings.json`:
105
123
  "mcp.servers": {
106
124
  "binance": {
107
125
  "command": "uvx",
108
- "args": ["binance-mcp-server"],
109
- "env": {
110
- "BINANCE_API_KEY": "your_api_key_here",
111
- "BINANCE_SECRET_KEY": "your_secret_key_here"
112
- }
126
+ "args": ["binance-futures-mcp", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"],
127
+ "env": {}
113
128
  }
114
129
  }
115
130
  }
@@ -123,12 +138,9 @@ Add to your Cursor configuration file (`.cursor/mcp.json`):
123
138
  {
124
139
  "servers": {
125
140
  "binance": {
126
- "command": "uvx",
127
- "args": ["binance-mcp-server"],
128
- "env": {
129
- "BINANCE_API_KEY": "your_api_key_here",
130
- "BINANCE_SECRET_KEY": "your_secret_key_here"
131
- }
141
+ "command": "uvx",
142
+ "args": ["binance-futures-mcp", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"],
143
+ "env": {}
132
144
  }
133
145
  }
134
146
  }
@@ -143,11 +155,8 @@ Add to your Windsurf configuration (`.windsurf/mcp.json`):
143
155
  "mcpServers": {
144
156
  "binance": {
145
157
  "command": "uvx",
146
- "args": ["binance-mcp-server"],
147
- "env": {
148
- "BINANCE_API_KEY": "your_api_key_here",
149
- "BINANCE_SECRET_KEY": "your_secret_key_here"
150
- }
158
+ "args": ["binance-futures-mcp", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"],
159
+ "env": {}
151
160
  }
152
161
  }
153
162
  }
@@ -165,11 +174,8 @@ Add to your Claude Desktop configuration file:
165
174
  "mcpServers": {
166
175
  "binance": {
167
176
  "command": "uvx",
168
- "args": ["binance-mcp-server"],
169
- "env": {
170
- "BINANCE_API_KEY": "your_api_key_here",
171
- "BINANCE_SECRET_KEY": "your_secret_key_here"
172
- }
177
+ "args": ["binance-futures-mcp", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"],
178
+ "env": {}
173
179
  }
174
180
  }
175
181
  }
@@ -179,42 +185,25 @@ Add to your Claude Desktop configuration file:
179
185
 
180
186
  1. **No path needed**: With PyPI installation, you don't need to specify paths or working directories.
181
187
 
182
- 2. **Set API credentials**: Replace `your_api_key_here` and `your_secret_key_here` with your actual Binance API credentials.
188
+ 2. **Set API credentials**: Replace `your_api_key` and `your_secret_key` with your actual Binance API credentials.
183
189
 
184
190
  3. **Alternative commands**: You can also use:
185
- - `pip install binance-mcp-server && python -m binance_mcp`
186
- - `binance-mcp-server` (if installed globally)
191
+ - `pip install binance-futures-mcp && python -m binance_mcp`
192
+ - `binance-mcp-server` (if installed globally and on PATH)
187
193
 
188
194
  4. **Python environment**: Using `uvx` automatically handles the Python environment.
189
195
 
190
196
  5. **Security**: For production use, consider storing credentials in your system's environment variables instead of directly in configuration files.
191
197
 
192
- ## Installation
193
-
194
- ### Prerequisites
195
- - Python 3.8 or higher
196
- - Binance Futures API credentials
197
-
198
- ### Method 1: Install via uvx (Recommended)
199
-
200
- ```bash
201
- uvx --from git+https://github.com/alexcandrabersiva/bin-mcp binance-mcp-server
202
- ```
203
-
204
- ### Method 2: Local Installation
205
-
206
- ```bash
207
- cd binance-mcp-server
208
- pip install -e .
209
- ```
198
+ ## Configuration
210
199
 
211
- Or install development dependencies:
200
+ ### API Requirements
212
201
 
213
- ```bash
214
- pip install -e ".[dev]"
215
- ```
202
+ Your Binance API key needs the following permissions:
203
+ - **Futures Trading**: For order placement and management
204
+ - **Futures Reading**: For account and market data access
216
205
 
217
- ## Configuration
206
+ **Note**: Market data endpoints (exchange info, prices, order books, etc.) work without authentication.
218
207
 
219
208
  ### Environment Variables
220
209
 
@@ -225,24 +214,19 @@ export BINANCE_API_KEY="your_api_key_here"
225
214
  export BINANCE_SECRET_KEY="your_secret_key_here"
226
215
  ```
227
216
 
228
- ### API Permissions
229
-
230
- Your Binance API key needs the following permissions:
231
- - **Futures Trading**: For order placement and management
232
- - **Futures Reading**: For account and market data access
233
-
234
- **Note**: Market data endpoints (exchange info, prices, order books, etc.) work without authentication.
235
-
236
217
  ## Usage
237
218
 
238
219
  ### Running the Server
239
220
 
240
221
  ```bash
241
- # Run directly
222
+ # Run directly (after installing from PyPI)
242
223
  python -m binance_mcp
243
224
 
244
- # Or using the installed script
245
- binance-mcp-server
225
+ # Or using uvx (no installation needed)
226
+ uvx binance-futures-mcp
227
+
228
+ # With API credentials as arguments
229
+ uvx binance-futures-mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
246
230
  ```
247
231
 
248
232
  ### Available Tools
@@ -2,6 +2,30 @@
2
2
 
3
3
  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.
4
4
 
5
+ ## Quick Start
6
+
7
+ 1. **Install the package:**
8
+ ```bash
9
+ pip install binance-futures-mcp
10
+ ```
11
+
12
+ 2. **Run the server:**
13
+ ```bash
14
+ uvx binance-futures-mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
15
+ ```
16
+
17
+ 3. **Or configure in VS Code** by adding to your `settings.json`:
18
+ ```json
19
+ {
20
+ "mcp.servers": {
21
+ "binance": {
22
+ "command": "uvx",
23
+ "args": ["binance-futures-mcp", "--binance-api-key", "your_key", "--binance-secret-key", "your_secret"]
24
+ }
25
+ }
26
+ }
27
+ ```
28
+
5
29
  ## Features
6
30
 
7
31
  ### Account Information Tools
@@ -35,26 +59,17 @@ A Model Context Protocol (MCP) server that provides comprehensive access to Bina
35
59
 
36
60
  ## Installation
37
61
 
38
- ### Prerequisites
39
- - Python 3.8 or higher
40
- - Binance Futures API credentials
41
-
42
- ### Method 1: Install via uvx (Recommended)
43
-
44
62
  ```bash
45
- uvx --from git+https://github.com/alexcandrabersiva/bin-mcp binance-mcp-server
63
+ pip install binance-futures-mcp
46
64
  ```
47
65
 
48
- ### Method 2: Local Installation
49
-
50
- ```bash
51
- cd binance-mcp-server
52
- pip install -e .
53
- ```
66
+ ### Development Installation
54
67
 
55
- Or install development dependencies:
68
+ For development, you can install from source:
56
69
 
57
70
  ```bash
71
+ git clone https://github.com/bin-mcp/binance-mcp-server.git
72
+ cd binance-mcp-server
58
73
  pip install -e ".[dev]"
59
74
  ```
60
75
 
@@ -71,11 +86,8 @@ Add to your VS Code `settings.json`:
71
86
  "mcp.servers": {
72
87
  "binance": {
73
88
  "command": "uvx",
74
- "args": ["binance-mcp-server"],
75
- "env": {
76
- "BINANCE_API_KEY": "your_api_key_here",
77
- "BINANCE_SECRET_KEY": "your_secret_key_here"
78
- }
89
+ "args": ["binance-futures-mcp", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"],
90
+ "env": {}
79
91
  }
80
92
  }
81
93
  }
@@ -89,12 +101,9 @@ Add to your Cursor configuration file (`.cursor/mcp.json`):
89
101
  {
90
102
  "servers": {
91
103
  "binance": {
92
- "command": "uvx",
93
- "args": ["binance-mcp-server"],
94
- "env": {
95
- "BINANCE_API_KEY": "your_api_key_here",
96
- "BINANCE_SECRET_KEY": "your_secret_key_here"
97
- }
104
+ "command": "uvx",
105
+ "args": ["binance-futures-mcp", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"],
106
+ "env": {}
98
107
  }
99
108
  }
100
109
  }
@@ -109,11 +118,8 @@ Add to your Windsurf configuration (`.windsurf/mcp.json`):
109
118
  "mcpServers": {
110
119
  "binance": {
111
120
  "command": "uvx",
112
- "args": ["binance-mcp-server"],
113
- "env": {
114
- "BINANCE_API_KEY": "your_api_key_here",
115
- "BINANCE_SECRET_KEY": "your_secret_key_here"
116
- }
121
+ "args": ["binance-futures-mcp", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"],
122
+ "env": {}
117
123
  }
118
124
  }
119
125
  }
@@ -131,11 +137,8 @@ Add to your Claude Desktop configuration file:
131
137
  "mcpServers": {
132
138
  "binance": {
133
139
  "command": "uvx",
134
- "args": ["binance-mcp-server"],
135
- "env": {
136
- "BINANCE_API_KEY": "your_api_key_here",
137
- "BINANCE_SECRET_KEY": "your_secret_key_here"
138
- }
140
+ "args": ["binance-futures-mcp", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"],
141
+ "env": {}
139
142
  }
140
143
  }
141
144
  }
@@ -145,42 +148,25 @@ Add to your Claude Desktop configuration file:
145
148
 
146
149
  1. **No path needed**: With PyPI installation, you don't need to specify paths or working directories.
147
150
 
148
- 2. **Set API credentials**: Replace `your_api_key_here` and `your_secret_key_here` with your actual Binance API credentials.
151
+ 2. **Set API credentials**: Replace `your_api_key` and `your_secret_key` with your actual Binance API credentials.
149
152
 
150
153
  3. **Alternative commands**: You can also use:
151
- - `pip install binance-mcp-server && python -m binance_mcp`
152
- - `binance-mcp-server` (if installed globally)
154
+ - `pip install binance-futures-mcp && python -m binance_mcp`
155
+ - `binance-mcp-server` (if installed globally and on PATH)
153
156
 
154
157
  4. **Python environment**: Using `uvx` automatically handles the Python environment.
155
158
 
156
159
  5. **Security**: For production use, consider storing credentials in your system's environment variables instead of directly in configuration files.
157
160
 
158
- ## Installation
159
-
160
- ### Prerequisites
161
- - Python 3.8 or higher
162
- - Binance Futures API credentials
163
-
164
- ### Method 1: Install via uvx (Recommended)
165
-
166
- ```bash
167
- uvx --from git+https://github.com/alexcandrabersiva/bin-mcp binance-mcp-server
168
- ```
169
-
170
- ### Method 2: Local Installation
171
-
172
- ```bash
173
- cd binance-mcp-server
174
- pip install -e .
175
- ```
161
+ ## Configuration
176
162
 
177
- Or install development dependencies:
163
+ ### API Requirements
178
164
 
179
- ```bash
180
- pip install -e ".[dev]"
181
- ```
165
+ Your Binance API key needs the following permissions:
166
+ - **Futures Trading**: For order placement and management
167
+ - **Futures Reading**: For account and market data access
182
168
 
183
- ## Configuration
169
+ **Note**: Market data endpoints (exchange info, prices, order books, etc.) work without authentication.
184
170
 
185
171
  ### Environment Variables
186
172
 
@@ -191,24 +177,19 @@ export BINANCE_API_KEY="your_api_key_here"
191
177
  export BINANCE_SECRET_KEY="your_secret_key_here"
192
178
  ```
193
179
 
194
- ### API Permissions
195
-
196
- Your Binance API key needs the following permissions:
197
- - **Futures Trading**: For order placement and management
198
- - **Futures Reading**: For account and market data access
199
-
200
- **Note**: Market data endpoints (exchange info, prices, order books, etc.) work without authentication.
201
-
202
180
  ## Usage
203
181
 
204
182
  ### Running the Server
205
183
 
206
184
  ```bash
207
- # Run directly
185
+ # Run directly (after installing from PyPI)
208
186
  python -m binance_mcp
209
187
 
210
- # Or using the installed script
211
- binance-mcp-server
188
+ # Or using uvx (no installation needed)
189
+ uvx binance-futures-mcp
190
+
191
+ # With API credentials as arguments
192
+ uvx binance-futures-mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
212
193
  ```
213
194
 
214
195
  ### Available Tools
@@ -0,0 +1,46 @@
1
+ #!/usr/bin/env python3
2
+
3
+ from setuptools import setup, find_packages
4
+
5
+ with open("README.md", "r", encoding="utf-8") as fh:
6
+ long_description = fh.read()
7
+
8
+ setup(
9
+ name="binance-futures-mcp",
10
+ version="1.0.2",
11
+ author="Binance MCP Server",
12
+ description="A Model Context Protocol server for Binance Futures API",
13
+ long_description=long_description,
14
+ long_description_content_type="text/markdown",
15
+ url="https://github.com/alexcandrabersiva/bin-mcp",
16
+ project_urls={
17
+ "Bug Tracker": "https://github.com/alexcandrabersiva/bin-mcp/issues",
18
+ "Repository": "https://github.com/alexcandrabersiva/bin-mcp.git",
19
+ },
20
+ classifiers=[
21
+ "Development Status :: 4 - Beta",
22
+ "Intended Audience :: Developers",
23
+ "Programming Language :: Python :: 3",
24
+ "Programming Language :: Python :: 3.8",
25
+ "Programming Language :: Python :: 3.9",
26
+ "Programming Language :: Python :: 3.10",
27
+ "Programming Language :: Python :: 3.11",
28
+ "Programming Language :: Python :: 3.12",
29
+ "Topic :: Software Development :: Libraries :: Python Modules",
30
+ "Topic :: Office/Business :: Financial :: Investment",
31
+ ],
32
+ package_dir={"": "src"},
33
+ packages=find_packages(where="src"),
34
+ python_requires=">=3.8",
35
+ install_requires=[
36
+ "mcp>=1.0.0",
37
+ "aiohttp>=3.8.0",
38
+ "pydantic>=2.0.0",
39
+ ],
40
+ entry_points={
41
+ "console_scripts": [
42
+ "binance-mcp-server=binance_mcp.__main__:cli_main",
43
+ ],
44
+ },
45
+ keywords="mcp binance trading futures api model-context-protocol",
46
+ )
@@ -1,13 +1,12 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: binance-futures-mcp
3
- Version: 1.0.0
3
+ Version: 1.0.2
4
4
  Summary: A Model Context Protocol server for Binance Futures API
5
+ Home-page: https://github.com/alexcandrabersiva/bin-mcp
5
6
  Author: Binance MCP Server
6
- License: MIT
7
- Project-URL: Homepage, https://github.com/bin-mcp/binance-mcp-server
8
- Project-URL: Repository, https://github.com/bin-mcp/binance-mcp-server.git
9
- Project-URL: Issues, https://github.com/bin-mcp/binance-mcp-server/issues
10
- Keywords: mcp,binance,trading,futures,api,model-context-protocol
7
+ Project-URL: Bug Tracker, https://github.com/alexcandrabersiva/bin-mcp/issues
8
+ Project-URL: Repository, https://github.com/alexcandrabersiva/bin-mcp.git
9
+ Keywords: mcp binance trading futures api model-context-protocol
11
10
  Classifier: Development Status :: 4 - Beta
12
11
  Classifier: Intended Audience :: Developers
13
12
  Classifier: Programming Language :: Python :: 3
@@ -24,18 +23,46 @@ License-File: LICENSE
24
23
  Requires-Dist: mcp>=1.0.0
25
24
  Requires-Dist: aiohttp>=3.8.0
26
25
  Requires-Dist: pydantic>=2.0.0
27
- Provides-Extra: dev
28
- Requires-Dist: pytest>=7.0.0; extra == "dev"
29
- Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
30
- Requires-Dist: black>=23.0.0; extra == "dev"
31
- Requires-Dist: mypy>=1.0.0; extra == "dev"
32
- Requires-Dist: ruff>=0.1.0; extra == "dev"
26
+ Dynamic: author
27
+ Dynamic: classifier
28
+ Dynamic: description
29
+ Dynamic: description-content-type
30
+ Dynamic: home-page
31
+ Dynamic: keywords
33
32
  Dynamic: license-file
33
+ Dynamic: project-url
34
+ Dynamic: requires-dist
35
+ Dynamic: requires-python
36
+ Dynamic: summary
34
37
 
35
38
  # Binance MCP Server
36
39
 
37
40
  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.
38
41
 
42
+ ## Quick Start
43
+
44
+ 1. **Install the package:**
45
+ ```bash
46
+ pip install binance-futures-mcp
47
+ ```
48
+
49
+ 2. **Run the server:**
50
+ ```bash
51
+ uvx binance-futures-mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
52
+ ```
53
+
54
+ 3. **Or configure in VS Code** by adding to your `settings.json`:
55
+ ```json
56
+ {
57
+ "mcp.servers": {
58
+ "binance": {
59
+ "command": "uvx",
60
+ "args": ["binance-futures-mcp", "--binance-api-key", "your_key", "--binance-secret-key", "your_secret"]
61
+ }
62
+ }
63
+ }
64
+ ```
65
+
39
66
  ## Features
40
67
 
41
68
  ### Account Information Tools
@@ -69,26 +96,17 @@ A Model Context Protocol (MCP) server that provides comprehensive access to Bina
69
96
 
70
97
  ## Installation
71
98
 
72
- ### Prerequisites
73
- - Python 3.8 or higher
74
- - Binance Futures API credentials
75
-
76
- ### Method 1: Install via uvx (Recommended)
77
-
78
99
  ```bash
79
- uvx --from git+https://github.com/alexcandrabersiva/bin-mcp binance-mcp-server
100
+ pip install binance-futures-mcp
80
101
  ```
81
102
 
82
- ### Method 2: Local Installation
83
-
84
- ```bash
85
- cd binance-mcp-server
86
- pip install -e .
87
- ```
103
+ ### Development Installation
88
104
 
89
- Or install development dependencies:
105
+ For development, you can install from source:
90
106
 
91
107
  ```bash
108
+ git clone https://github.com/bin-mcp/binance-mcp-server.git
109
+ cd binance-mcp-server
92
110
  pip install -e ".[dev]"
93
111
  ```
94
112
 
@@ -105,11 +123,8 @@ Add to your VS Code `settings.json`:
105
123
  "mcp.servers": {
106
124
  "binance": {
107
125
  "command": "uvx",
108
- "args": ["binance-mcp-server"],
109
- "env": {
110
- "BINANCE_API_KEY": "your_api_key_here",
111
- "BINANCE_SECRET_KEY": "your_secret_key_here"
112
- }
126
+ "args": ["binance-futures-mcp", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"],
127
+ "env": {}
113
128
  }
114
129
  }
115
130
  }
@@ -123,12 +138,9 @@ Add to your Cursor configuration file (`.cursor/mcp.json`):
123
138
  {
124
139
  "servers": {
125
140
  "binance": {
126
- "command": "uvx",
127
- "args": ["binance-mcp-server"],
128
- "env": {
129
- "BINANCE_API_KEY": "your_api_key_here",
130
- "BINANCE_SECRET_KEY": "your_secret_key_here"
131
- }
141
+ "command": "uvx",
142
+ "args": ["binance-futures-mcp", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"],
143
+ "env": {}
132
144
  }
133
145
  }
134
146
  }
@@ -143,11 +155,8 @@ Add to your Windsurf configuration (`.windsurf/mcp.json`):
143
155
  "mcpServers": {
144
156
  "binance": {
145
157
  "command": "uvx",
146
- "args": ["binance-mcp-server"],
147
- "env": {
148
- "BINANCE_API_KEY": "your_api_key_here",
149
- "BINANCE_SECRET_KEY": "your_secret_key_here"
150
- }
158
+ "args": ["binance-futures-mcp", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"],
159
+ "env": {}
151
160
  }
152
161
  }
153
162
  }
@@ -165,11 +174,8 @@ Add to your Claude Desktop configuration file:
165
174
  "mcpServers": {
166
175
  "binance": {
167
176
  "command": "uvx",
168
- "args": ["binance-mcp-server"],
169
- "env": {
170
- "BINANCE_API_KEY": "your_api_key_here",
171
- "BINANCE_SECRET_KEY": "your_secret_key_here"
172
- }
177
+ "args": ["binance-futures-mcp", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"],
178
+ "env": {}
173
179
  }
174
180
  }
175
181
  }
@@ -179,42 +185,25 @@ Add to your Claude Desktop configuration file:
179
185
 
180
186
  1. **No path needed**: With PyPI installation, you don't need to specify paths or working directories.
181
187
 
182
- 2. **Set API credentials**: Replace `your_api_key_here` and `your_secret_key_here` with your actual Binance API credentials.
188
+ 2. **Set API credentials**: Replace `your_api_key` and `your_secret_key` with your actual Binance API credentials.
183
189
 
184
190
  3. **Alternative commands**: You can also use:
185
- - `pip install binance-mcp-server && python -m binance_mcp`
186
- - `binance-mcp-server` (if installed globally)
191
+ - `pip install binance-futures-mcp && python -m binance_mcp`
192
+ - `binance-mcp-server` (if installed globally and on PATH)
187
193
 
188
194
  4. **Python environment**: Using `uvx` automatically handles the Python environment.
189
195
 
190
196
  5. **Security**: For production use, consider storing credentials in your system's environment variables instead of directly in configuration files.
191
197
 
192
- ## Installation
193
-
194
- ### Prerequisites
195
- - Python 3.8 or higher
196
- - Binance Futures API credentials
197
-
198
- ### Method 1: Install via uvx (Recommended)
199
-
200
- ```bash
201
- uvx --from git+https://github.com/alexcandrabersiva/bin-mcp binance-mcp-server
202
- ```
203
-
204
- ### Method 2: Local Installation
205
-
206
- ```bash
207
- cd binance-mcp-server
208
- pip install -e .
209
- ```
198
+ ## Configuration
210
199
 
211
- Or install development dependencies:
200
+ ### API Requirements
212
201
 
213
- ```bash
214
- pip install -e ".[dev]"
215
- ```
202
+ Your Binance API key needs the following permissions:
203
+ - **Futures Trading**: For order placement and management
204
+ - **Futures Reading**: For account and market data access
216
205
 
217
- ## Configuration
206
+ **Note**: Market data endpoints (exchange info, prices, order books, etc.) work without authentication.
218
207
 
219
208
  ### Environment Variables
220
209
 
@@ -225,24 +214,19 @@ export BINANCE_API_KEY="your_api_key_here"
225
214
  export BINANCE_SECRET_KEY="your_secret_key_here"
226
215
  ```
227
216
 
228
- ### API Permissions
229
-
230
- Your Binance API key needs the following permissions:
231
- - **Futures Trading**: For order placement and management
232
- - **Futures Reading**: For account and market data access
233
-
234
- **Note**: Market data endpoints (exchange info, prices, order books, etc.) work without authentication.
235
-
236
217
  ## Usage
237
218
 
238
219
  ### Running the Server
239
220
 
240
221
  ```bash
241
- # Run directly
222
+ # Run directly (after installing from PyPI)
242
223
  python -m binance_mcp
243
224
 
244
- # Or using the installed script
245
- binance-mcp-server
225
+ # Or using uvx (no installation needed)
226
+ uvx binance-futures-mcp
227
+
228
+ # With API credentials as arguments
229
+ uvx binance-futures-mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
246
230
  ```
247
231
 
248
232
  ### Available Tools
@@ -1,6 +1,6 @@
1
1
  LICENSE
2
2
  README.md
3
- pyproject.toml
3
+ setup.py
4
4
  src/binance_futures_mcp.egg-info/PKG-INFO
5
5
  src/binance_futures_mcp.egg-info/SOURCES.txt
6
6
  src/binance_futures_mcp.egg-info/dependency_links.txt
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ binance-mcp-server = binance_mcp.__main__:cli_main
@@ -0,0 +1,3 @@
1
+ mcp>=1.0.0
2
+ aiohttp>=3.8.0
3
+ pydantic>=2.0.0
@@ -1,7 +1,13 @@
1
1
  #!/usr/bin/env python3
2
2
 
3
+ import asyncio
3
4
  from binance_mcp.server import main
4
5
 
5
- if __name__ == "__main__":
6
- import asyncio
6
+
7
+ def cli_main():
8
+ """Entry point for the command-line interface"""
7
9
  asyncio.run(main())
10
+
11
+
12
+ if __name__ == "__main__":
13
+ cli_main()
@@ -750,8 +750,10 @@ async def main():
750
750
  write_stream,
751
751
  InitializationOptions(
752
752
  server_name="binance-futures-mcp-server",
753
- server_version="1.0.0",
754
- capabilities={}
753
+ server_version="1.0.1",
754
+ capabilities={
755
+ "tools": {}
756
+ }
755
757
  )
756
758
  )
757
759
 
@@ -1,67 +0,0 @@
1
- [build-system]
2
- requires = ["setuptools>=61.0", "wheel"]
3
- build-backend = "setuptools.build_meta"
4
-
5
- [project]
6
- name = "binance-futures-mcp"
7
- version = "1.0.0"
8
- description = "A Model Context Protocol server for Binance Futures API"
9
- authors = [
10
- {name = "Binance MCP Server"}
11
- ]
12
- license = {text = "MIT"}
13
- readme = "README.md"
14
- requires-python = ">=3.8"
15
- keywords = ["mcp", "binance", "trading", "futures", "api", "model-context-protocol"]
16
- classifiers = [
17
- "Development Status :: 4 - Beta",
18
- "Intended Audience :: Developers",
19
- "Programming Language :: Python :: 3",
20
- "Programming Language :: Python :: 3.8",
21
- "Programming Language :: Python :: 3.9",
22
- "Programming Language :: Python :: 3.10",
23
- "Programming Language :: Python :: 3.11",
24
- "Programming Language :: Python :: 3.12",
25
- "Topic :: Software Development :: Libraries :: Python Modules",
26
- "Topic :: Office/Business :: Financial :: Investment",
27
- ]
28
- dependencies = [
29
- "mcp>=1.0.0",
30
- "aiohttp>=3.8.0",
31
- "pydantic>=2.0.0",
32
- ]
33
-
34
- [project.optional-dependencies]
35
- dev = [
36
- "pytest>=7.0.0",
37
- "pytest-asyncio>=0.21.0",
38
- "black>=23.0.0",
39
- "mypy>=1.0.0",
40
- "ruff>=0.1.0",
41
- ]
42
-
43
- [project.scripts]
44
- binance-mcp-server = "binance_mcp.__main__:main"
45
-
46
- [project.urls]
47
- Homepage = "https://github.com/bin-mcp/binance-mcp-server"
48
- Repository = "https://github.com/bin-mcp/binance-mcp-server.git"
49
- Issues = "https://github.com/bin-mcp/binance-mcp-server/issues"
50
-
51
- [tool.setuptools.packages.find]
52
- where = ["src"]
53
-
54
- [tool.black]
55
- line-length = 88
56
- target-version = ["py38"]
57
-
58
- [tool.ruff]
59
- line-length = 88
60
- target-version = "py38"
61
- select = ["E", "F", "I", "N", "W", "UP"]
62
-
63
- [tool.mypy]
64
- python_version = "3.8"
65
- warn_return_any = true
66
- warn_unused_configs = true
67
- disallow_untyped_defs = true
@@ -1,2 +0,0 @@
1
- [console_scripts]
2
- binance-mcp-server = binance_mcp.__main__:main
@@ -1,10 +0,0 @@
1
- mcp>=1.0.0
2
- aiohttp>=3.8.0
3
- pydantic>=2.0.0
4
-
5
- [dev]
6
- pytest>=7.0.0
7
- pytest-asyncio>=0.21.0
8
- black>=23.0.0
9
- mypy>=1.0.0
10
- ruff>=0.1.0