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.
- {binance_futures_mcp-1.0.0/src/binance_futures_mcp.egg-info → binance_futures_mcp-1.0.2}/PKG-INFO +68 -84
- {binance_futures_mcp-1.0.0 → binance_futures_mcp-1.0.2}/README.md +53 -72
- binance_futures_mcp-1.0.2/setup.py +46 -0
- {binance_futures_mcp-1.0.0 → binance_futures_mcp-1.0.2/src/binance_futures_mcp.egg-info}/PKG-INFO +68 -84
- {binance_futures_mcp-1.0.0 → binance_futures_mcp-1.0.2}/src/binance_futures_mcp.egg-info/SOURCES.txt +1 -1
- binance_futures_mcp-1.0.2/src/binance_futures_mcp.egg-info/entry_points.txt +2 -0
- binance_futures_mcp-1.0.2/src/binance_futures_mcp.egg-info/requires.txt +3 -0
- {binance_futures_mcp-1.0.0 → binance_futures_mcp-1.0.2}/src/binance_mcp/__main__.py +8 -2
- {binance_futures_mcp-1.0.0 → binance_futures_mcp-1.0.2}/src/binance_mcp/server.py +4 -2
- binance_futures_mcp-1.0.0/pyproject.toml +0 -67
- binance_futures_mcp-1.0.0/src/binance_futures_mcp.egg-info/entry_points.txt +0 -2
- binance_futures_mcp-1.0.0/src/binance_futures_mcp.egg-info/requires.txt +0 -10
- {binance_futures_mcp-1.0.0 → binance_futures_mcp-1.0.2}/LICENSE +0 -0
- {binance_futures_mcp-1.0.0 → binance_futures_mcp-1.0.2}/setup.cfg +0 -0
- {binance_futures_mcp-1.0.0 → binance_futures_mcp-1.0.2}/src/binance_futures_mcp.egg-info/dependency_links.txt +0 -0
- {binance_futures_mcp-1.0.0 → binance_futures_mcp-1.0.2}/src/binance_futures_mcp.egg-info/top_level.txt +0 -0
- {binance_futures_mcp-1.0.0 → binance_futures_mcp-1.0.2}/src/binance_mcp/__init__.py +0 -0
{binance_futures_mcp-1.0.0/src/binance_futures_mcp.egg-info → binance_futures_mcp-1.0.2}/PKG-INFO
RENAMED
@@ -1,13 +1,12 @@
|
|
1
1
|
Metadata-Version: 2.4
|
2
2
|
Name: binance-futures-mcp
|
3
|
-
Version: 1.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
|
-
|
7
|
-
Project-URL:
|
8
|
-
|
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
|
-
|
28
|
-
|
29
|
-
|
30
|
-
|
31
|
-
|
32
|
-
|
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
|
-
|
100
|
+
pip install binance-futures-mcp
|
80
101
|
```
|
81
102
|
|
82
|
-
###
|
83
|
-
|
84
|
-
```bash
|
85
|
-
cd binance-mcp-server
|
86
|
-
pip install -e .
|
87
|
-
```
|
103
|
+
### Development Installation
|
88
104
|
|
89
|
-
|
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-
|
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-
|
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-
|
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-
|
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 `
|
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
|
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
|
-
##
|
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
|
-
|
200
|
+
### API Requirements
|
212
201
|
|
213
|
-
|
214
|
-
|
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
|
-
|
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
|
245
|
-
binance-mcp
|
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
|
-
|
63
|
+
pip install binance-futures-mcp
|
46
64
|
```
|
47
65
|
|
48
|
-
###
|
49
|
-
|
50
|
-
```bash
|
51
|
-
cd binance-mcp-server
|
52
|
-
pip install -e .
|
53
|
-
```
|
66
|
+
### Development Installation
|
54
67
|
|
55
|
-
|
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-
|
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-
|
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-
|
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-
|
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 `
|
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
|
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
|
-
##
|
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
|
-
|
163
|
+
### API Requirements
|
178
164
|
|
179
|
-
|
180
|
-
|
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
|
-
|
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
|
211
|
-
binance-mcp
|
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
|
+
)
|
{binance_futures_mcp-1.0.0 → binance_futures_mcp-1.0.2/src/binance_futures_mcp.egg-info}/PKG-INFO
RENAMED
@@ -1,13 +1,12 @@
|
|
1
1
|
Metadata-Version: 2.4
|
2
2
|
Name: binance-futures-mcp
|
3
|
-
Version: 1.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
|
-
|
7
|
-
Project-URL:
|
8
|
-
|
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
|
-
|
28
|
-
|
29
|
-
|
30
|
-
|
31
|
-
|
32
|
-
|
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
|
-
|
100
|
+
pip install binance-futures-mcp
|
80
101
|
```
|
81
102
|
|
82
|
-
###
|
83
|
-
|
84
|
-
```bash
|
85
|
-
cd binance-mcp-server
|
86
|
-
pip install -e .
|
87
|
-
```
|
103
|
+
### Development Installation
|
88
104
|
|
89
|
-
|
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-
|
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-
|
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-
|
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-
|
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 `
|
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
|
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
|
-
##
|
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
|
-
|
200
|
+
### API Requirements
|
212
201
|
|
213
|
-
|
214
|
-
|
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
|
-
|
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
|
245
|
-
binance-mcp
|
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,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
|
-
|
6
|
-
|
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()
|
@@ -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
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|