binance-futures-mcp 1.0.6__tar.gz → 1.0.7__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,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
- Name: binance-futures-mcp
3
- Version: 1.0.6
2
+ Name: binance_futures_mcp
3
+ Version: 1.0.7
4
4
  Summary: A Model Context Protocol server for Binance Futures API
5
5
  Home-page: https://github.com/alexcandrabersiva/bin-mcp
6
6
  Author: Binance MCP Server
@@ -29,12 +29,12 @@ A Model Context Protocol (MCP) server that provides comprehensive access to Bina
29
29
 
30
30
  1. **Install the package:**
31
31
  ```bash
32
- pip install binance-futures-mcp
32
+ pip install binance_futures_mcp
33
33
  ```
34
34
 
35
35
  2. **Run the server:**
36
36
  ```bash
37
- uvx binance-futures-mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
37
+ uvx binance_futures_mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
38
38
  ```
39
39
 
40
40
  3. **Or configure in VS Code** by adding to your `settings.json`:
@@ -44,7 +44,7 @@ A Model Context Protocol (MCP) server that provides comprehensive access to Bina
44
44
  "servers": {
45
45
  "binance": {
46
46
  "command": "uvx",
47
- "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_key", "--binance-secret-key", "your_secret"]
47
+ "args": ["--from", "binance_futures_mcp", "binance-mcp-server.exe", "--binance-api-key", "your_key", "--binance-secret-key", "your_secret"]
48
48
  }
49
49
  }
50
50
  }
@@ -85,7 +85,7 @@ A Model Context Protocol (MCP) server that provides comprehensive access to Bina
85
85
  ## Installation
86
86
 
87
87
  ```bash
88
- pip install binance-futures-mcp
88
+ pip install binance_futures_mcp
89
89
  ```
90
90
 
91
91
  ### Development Installation
@@ -112,7 +112,7 @@ Add to your VS Code `settings.json`:
112
112
  "servers": {
113
113
  "binance": {
114
114
  "command": "uvx",
115
- "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
115
+ "args": ["--from", "binance_futures_mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
116
116
  }
117
117
  }
118
118
  }
@@ -128,7 +128,7 @@ Add to your Cursor configuration file (`.cursor/mcp.json`):
128
128
  "servers": {
129
129
  "binance": {
130
130
  "command": "uvx",
131
- "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
131
+ "args": ["--from", "binance_futures_mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
132
132
  }
133
133
  }
134
134
  }
@@ -143,7 +143,7 @@ Add to your Windsurf configuration (`.windsurf/mcp.json`):
143
143
  "mcpServers": {
144
144
  "binance": {
145
145
  "command": "uvx",
146
- "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
146
+ "args": ["--from", "binance_futures_mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
147
147
  }
148
148
  }
149
149
  }
@@ -161,7 +161,7 @@ Add to your Claude Desktop configuration file:
161
161
  "mcpServers": {
162
162
  "binance": {
163
163
  "command": "uvx",
164
- "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
164
+ "args": ["--from", "binance_futures_mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
165
165
  }
166
166
  }
167
167
  }
@@ -174,9 +174,9 @@ Add to your Claude Desktop configuration file:
174
174
  2. **Set API credentials**: Replace `your_api_key` and `your_secret_key` with your actual Binance API credentials.
175
175
 
176
176
  2. **Alternative commands**: You can also use:
177
- - `uvx binance-futures-mcp` (direct package execution)
178
- - `uvx --from binance-futures-mcp binance-mcp-server.exe` (explicit executable)
179
- - `pip install binance-futures-mcp && python -m binance_mcp`
177
+ - `uvx binance_futures_mcp` (direct package execution)
178
+ - `uvx --from binance_futures_mcp binance-mcp-server.exe` (explicit executable)
179
+ - `pip install binance_futures_mcp && python -m binance_mcp`
180
180
 
181
181
  4. **Python environment**: Using `uvx` automatically handles the Python environment.
182
182
 
@@ -210,15 +210,15 @@ export BINANCE_SECRET_KEY="your_secret_key_here"
210
210
  python -m binance_mcp
211
211
 
212
212
  # Or using uvx (no installation needed)
213
- uvx binance-futures-mcp
213
+ uvx binance_futures_mcp
214
214
 
215
215
  # With API credentials as arguments
216
- uvx binance-futures-mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
216
+ uvx binance_futures_mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
217
217
  ```
218
218
 
219
219
  ### Available Tools
220
220
 
221
- The server provides 37 tools organized into categories:
221
+ The server provides 35 tools organized into categories:
222
222
 
223
223
  #### Account Information (5 tools)
224
224
  - `get_account_info` - Get futures account information
@@ -251,7 +251,7 @@ The server provides 37 tools organized into categories:
251
251
  - `change_position_mode` - Change position mode
252
252
  - `modify_position_margin` - Modify position margin
253
253
 
254
- #### Market Data (8 tools)
254
+ #### Market Data (10 tools)
255
255
  - `get_exchange_info` - Get trading rules and symbol info
256
256
  - `get_book_ticker` - Get best bid/ask prices
257
257
  - `get_price_ticker` - Get latest prices
@@ -261,11 +261,11 @@ The server provides 37 tools organized into categories:
261
261
  - `get_klines` - Get candlestick data
262
262
  - `get_mark_price` - Get mark price and funding rate
263
263
  - `get_aggregate_trades` - Get aggregate trade data
264
+ - `get_funding_rate_history` - Get funding rate history
264
265
 
265
- #### Trading History (3 tools)
266
+ #### Trading History (2 tools)
266
267
  - `get_account_trades` - Get account trade history
267
268
  - `get_income_history` - Get income history
268
- - `get_funding_rate_history` - Get funding rate history
269
269
 
270
270
  ## Example Usage
271
271
 
@@ -6,12 +6,12 @@ A Model Context Protocol (MCP) server that provides comprehensive access to Bina
6
6
 
7
7
  1. **Install the package:**
8
8
  ```bash
9
- pip install binance-futures-mcp
9
+ pip install binance_futures_mcp
10
10
  ```
11
11
 
12
12
  2. **Run the server:**
13
13
  ```bash
14
- uvx binance-futures-mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
14
+ uvx binance_futures_mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
15
15
  ```
16
16
 
17
17
  3. **Or configure in VS Code** by adding to your `settings.json`:
@@ -21,7 +21,7 @@ A Model Context Protocol (MCP) server that provides comprehensive access to Bina
21
21
  "servers": {
22
22
  "binance": {
23
23
  "command": "uvx",
24
- "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_key", "--binance-secret-key", "your_secret"]
24
+ "args": ["--from", "binance_futures_mcp", "binance-mcp-server.exe", "--binance-api-key", "your_key", "--binance-secret-key", "your_secret"]
25
25
  }
26
26
  }
27
27
  }
@@ -62,7 +62,7 @@ A Model Context Protocol (MCP) server that provides comprehensive access to Bina
62
62
  ## Installation
63
63
 
64
64
  ```bash
65
- pip install binance-futures-mcp
65
+ pip install binance_futures_mcp
66
66
  ```
67
67
 
68
68
  ### Development Installation
@@ -89,7 +89,7 @@ Add to your VS Code `settings.json`:
89
89
  "servers": {
90
90
  "binance": {
91
91
  "command": "uvx",
92
- "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
92
+ "args": ["--from", "binance_futures_mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
93
93
  }
94
94
  }
95
95
  }
@@ -105,7 +105,7 @@ Add to your Cursor configuration file (`.cursor/mcp.json`):
105
105
  "servers": {
106
106
  "binance": {
107
107
  "command": "uvx",
108
- "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
108
+ "args": ["--from", "binance_futures_mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
109
109
  }
110
110
  }
111
111
  }
@@ -120,7 +120,7 @@ Add to your Windsurf configuration (`.windsurf/mcp.json`):
120
120
  "mcpServers": {
121
121
  "binance": {
122
122
  "command": "uvx",
123
- "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
123
+ "args": ["--from", "binance_futures_mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
124
124
  }
125
125
  }
126
126
  }
@@ -138,7 +138,7 @@ Add to your Claude Desktop configuration file:
138
138
  "mcpServers": {
139
139
  "binance": {
140
140
  "command": "uvx",
141
- "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
141
+ "args": ["--from", "binance_futures_mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
142
142
  }
143
143
  }
144
144
  }
@@ -151,9 +151,9 @@ Add to your Claude Desktop configuration file:
151
151
  2. **Set API credentials**: Replace `your_api_key` and `your_secret_key` with your actual Binance API credentials.
152
152
 
153
153
  2. **Alternative commands**: You can also use:
154
- - `uvx binance-futures-mcp` (direct package execution)
155
- - `uvx --from binance-futures-mcp binance-mcp-server.exe` (explicit executable)
156
- - `pip install binance-futures-mcp && python -m binance_mcp`
154
+ - `uvx binance_futures_mcp` (direct package execution)
155
+ - `uvx --from binance_futures_mcp binance-mcp-server.exe` (explicit executable)
156
+ - `pip install binance_futures_mcp && python -m binance_mcp`
157
157
 
158
158
  4. **Python environment**: Using `uvx` automatically handles the Python environment.
159
159
 
@@ -187,15 +187,15 @@ export BINANCE_SECRET_KEY="your_secret_key_here"
187
187
  python -m binance_mcp
188
188
 
189
189
  # Or using uvx (no installation needed)
190
- uvx binance-futures-mcp
190
+ uvx binance_futures_mcp
191
191
 
192
192
  # With API credentials as arguments
193
- uvx binance-futures-mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
193
+ uvx binance_futures_mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
194
194
  ```
195
195
 
196
196
  ### Available Tools
197
197
 
198
- The server provides 37 tools organized into categories:
198
+ The server provides 35 tools organized into categories:
199
199
 
200
200
  #### Account Information (5 tools)
201
201
  - `get_account_info` - Get futures account information
@@ -228,7 +228,7 @@ The server provides 37 tools organized into categories:
228
228
  - `change_position_mode` - Change position mode
229
229
  - `modify_position_margin` - Modify position margin
230
230
 
231
- #### Market Data (8 tools)
231
+ #### Market Data (10 tools)
232
232
  - `get_exchange_info` - Get trading rules and symbol info
233
233
  - `get_book_ticker` - Get best bid/ask prices
234
234
  - `get_price_ticker` - Get latest prices
@@ -238,11 +238,11 @@ The server provides 37 tools organized into categories:
238
238
  - `get_klines` - Get candlestick data
239
239
  - `get_mark_price` - Get mark price and funding rate
240
240
  - `get_aggregate_trades` - Get aggregate trade data
241
+ - `get_funding_rate_history` - Get funding rate history
241
242
 
242
- #### Trading History (3 tools)
243
+ #### Trading History (2 tools)
243
244
  - `get_account_trades` - Get account trade history
244
245
  - `get_income_history` - Get income history
245
- - `get_funding_rate_history` - Get funding rate history
246
246
 
247
247
  ## Example Usage
248
248
 
@@ -6,8 +6,8 @@ with open("README.md", "r", encoding="utf-8") as fh:
6
6
  long_description = fh.read()
7
7
 
8
8
  setup(
9
- name="binance-futures-mcp",
10
- version="1.0.6",
9
+ name="binance_futures_mcp",
10
+ version="1.0.7",
11
11
  author="Binance MCP Server",
12
12
  description="A Model Context Protocol server for Binance Futures API",
13
13
  long_description=long_description,
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: binance-futures-mcp
3
- Version: 1.0.6
3
+ Version: 1.0.7
4
4
  Summary: A Model Context Protocol server for Binance Futures API
5
5
  Home-page: https://github.com/alexcandrabersiva/bin-mcp
6
6
  Author: Binance MCP Server
@@ -29,12 +29,12 @@ A Model Context Protocol (MCP) server that provides comprehensive access to Bina
29
29
 
30
30
  1. **Install the package:**
31
31
  ```bash
32
- pip install binance-futures-mcp
32
+ pip install binance_futures_mcp
33
33
  ```
34
34
 
35
35
  2. **Run the server:**
36
36
  ```bash
37
- uvx binance-futures-mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
37
+ uvx binance_futures_mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
38
38
  ```
39
39
 
40
40
  3. **Or configure in VS Code** by adding to your `settings.json`:
@@ -44,7 +44,7 @@ A Model Context Protocol (MCP) server that provides comprehensive access to Bina
44
44
  "servers": {
45
45
  "binance": {
46
46
  "command": "uvx",
47
- "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_key", "--binance-secret-key", "your_secret"]
47
+ "args": ["--from", "binance_futures_mcp", "binance-mcp-server.exe", "--binance-api-key", "your_key", "--binance-secret-key", "your_secret"]
48
48
  }
49
49
  }
50
50
  }
@@ -85,7 +85,7 @@ A Model Context Protocol (MCP) server that provides comprehensive access to Bina
85
85
  ## Installation
86
86
 
87
87
  ```bash
88
- pip install binance-futures-mcp
88
+ pip install binance_futures_mcp
89
89
  ```
90
90
 
91
91
  ### Development Installation
@@ -112,7 +112,7 @@ Add to your VS Code `settings.json`:
112
112
  "servers": {
113
113
  "binance": {
114
114
  "command": "uvx",
115
- "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
115
+ "args": ["--from", "binance_futures_mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
116
116
  }
117
117
  }
118
118
  }
@@ -128,7 +128,7 @@ Add to your Cursor configuration file (`.cursor/mcp.json`):
128
128
  "servers": {
129
129
  "binance": {
130
130
  "command": "uvx",
131
- "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
131
+ "args": ["--from", "binance_futures_mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
132
132
  }
133
133
  }
134
134
  }
@@ -143,7 +143,7 @@ Add to your Windsurf configuration (`.windsurf/mcp.json`):
143
143
  "mcpServers": {
144
144
  "binance": {
145
145
  "command": "uvx",
146
- "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
146
+ "args": ["--from", "binance_futures_mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
147
147
  }
148
148
  }
149
149
  }
@@ -161,7 +161,7 @@ Add to your Claude Desktop configuration file:
161
161
  "mcpServers": {
162
162
  "binance": {
163
163
  "command": "uvx",
164
- "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
164
+ "args": ["--from", "binance_futures_mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
165
165
  }
166
166
  }
167
167
  }
@@ -174,9 +174,9 @@ Add to your Claude Desktop configuration file:
174
174
  2. **Set API credentials**: Replace `your_api_key` and `your_secret_key` with your actual Binance API credentials.
175
175
 
176
176
  2. **Alternative commands**: You can also use:
177
- - `uvx binance-futures-mcp` (direct package execution)
178
- - `uvx --from binance-futures-mcp binance-mcp-server.exe` (explicit executable)
179
- - `pip install binance-futures-mcp && python -m binance_mcp`
177
+ - `uvx binance_futures_mcp` (direct package execution)
178
+ - `uvx --from binance_futures_mcp binance-mcp-server.exe` (explicit executable)
179
+ - `pip install binance_futures_mcp && python -m binance_mcp`
180
180
 
181
181
  4. **Python environment**: Using `uvx` automatically handles the Python environment.
182
182
 
@@ -210,15 +210,15 @@ export BINANCE_SECRET_KEY="your_secret_key_here"
210
210
  python -m binance_mcp
211
211
 
212
212
  # Or using uvx (no installation needed)
213
- uvx binance-futures-mcp
213
+ uvx binance_futures_mcp
214
214
 
215
215
  # With API credentials as arguments
216
- uvx binance-futures-mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
216
+ uvx binance_futures_mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
217
217
  ```
218
218
 
219
219
  ### Available Tools
220
220
 
221
- The server provides 37 tools organized into categories:
221
+ The server provides 35 tools organized into categories:
222
222
 
223
223
  #### Account Information (5 tools)
224
224
  - `get_account_info` - Get futures account information
@@ -251,7 +251,7 @@ The server provides 37 tools organized into categories:
251
251
  - `change_position_mode` - Change position mode
252
252
  - `modify_position_margin` - Modify position margin
253
253
 
254
- #### Market Data (8 tools)
254
+ #### Market Data (10 tools)
255
255
  - `get_exchange_info` - Get trading rules and symbol info
256
256
  - `get_book_ticker` - Get best bid/ask prices
257
257
  - `get_price_ticker` - Get latest prices
@@ -261,11 +261,11 @@ The server provides 37 tools organized into categories:
261
261
  - `get_klines` - Get candlestick data
262
262
  - `get_mark_price` - Get mark price and funding rate
263
263
  - `get_aggregate_trades` - Get aggregate trade data
264
+ - `get_funding_rate_history` - Get funding rate history
264
265
 
265
- #### Trading History (3 tools)
266
+ #### Trading History (2 tools)
266
267
  - `get_account_trades` - Get account trade history
267
268
  - `get_income_history` - Get income history
268
- - `get_funding_rate_history` - Get funding rate history
269
269
 
270
270
  ## Example Usage
271
271
 
@@ -48,7 +48,7 @@ class BinanceClient:
48
48
  timeout=timeout,
49
49
  connector=connector,
50
50
  headers={
51
- 'User-Agent': 'binance-mcp-server/1.0.6',
51
+ 'User-Agent': 'binance-mcp-server/1.0.7',
52
52
  'Content-Type': 'application/x-www-form-urlencoded'
53
53
  }
54
54
  )
@@ -816,7 +816,7 @@ async def main():
816
816
  write_stream,
817
817
  InitializationOptions(
818
818
  server_name="binance-futures-mcp-server",
819
- server_version="1.0.6",
819
+ server_version="1.0.7",
820
820
  capabilities={
821
821
  "tools": {}
822
822
  }