Skip to content

Commit 0bb3d3f

Browse files
committed
feat: 🔖 Release v2.1.0 - Pix code validation and improvements
- Enhanced PIX code generation with EMV 4.0 standard compliance - Improved validation for PIX keys (CPF, CNPJ, email, phone, UUID) - Fixed CRC16-CCITT calculation for accurate Pix codes - Added comprehensive PIX code validation and debugging - Cleaned up deprecated setup scripts and configurations - Updated deployment configuration for Railway - Enhanced error handling and validation messages - All tests passing with complete coverage
1 parent 2d4f733 commit 0bb3d3f

File tree

15 files changed

+103
-856
lines changed

15 files changed

+103
-856
lines changed

.env.example

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,2 @@
11
# Server Configuration
2-
PORT=3000
32
NODE_ENV=development

README.md

Lines changed: 13 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -59,10 +59,10 @@ curl -X POST http://localhost:3000/generate-static-pix \
5959
```typescript
6060
const result = await mcpClient.callTool('generateStaticPix', {
6161
pixKey: '12345678900',
62-
amount: 100.50,
62+
amount: 100.5,
6363
recipientName: 'John Doe',
6464
recipientCity: 'Sao Paulo',
65-
description: 'Payment for services'
65+
description: 'Payment for services',
6666
});
6767
```
6868

@@ -86,7 +86,7 @@ npm install
8686
npm run build
8787

8888
# Start the server
89-
NODE_ENV=production node dist/index.js --http --http-port $PORT
89+
NODE_ENV=production node dist/index.js --http --http-port 3000
9090
```
9191

9292
## 📝 License
@@ -97,17 +97,7 @@ MIT
9797

9898
### Environment Variables
9999

100-
- `EFI_CLIENT_ID`: Your Efí (Gerencianet) client ID
101-
- `EFI_CLIENT_SECRET`: Your Efí client secret
102-
- `EFI_SANDBOX`: Set to `true` for sandbox mode, `false` for production
103-
- `EFI_PIX_KEY`: Your Pix key (email, phone, CPF, or random key)
104-
105-
### Getting Efí Credentials
106-
107-
1. Create an account at [Efí (Gerencianet)](https://sejaefi.com.br/)
108-
2. Access the developer dashboard
109-
3. Create a new application to get your client ID and secret
110-
4. Configure your Pix key in the Efí dashboard
100+
- `NODE_ENV`: (Optional) Environment (development/production)
111101

112102
## 🤖 Usage with Claude Desktop
113103

@@ -121,16 +111,15 @@ MIT
121111
"command": "node",
122112
"args": ["/path/to/pix-mcp-server/dist/index.js"],
123113
"env": {
124-
"EFI_CLIENT_ID": "your_client_id",
125-
"EFI_CLIENT_SECRET": "your_client_secret",
126-
"EFI_SANDBOX": "true"
114+
# No external API keys needed for static Pix generation
127115
}
128116
}
129117
}
130118
}
131119
```
132120

133121
Then in Claude:
122+
134123
```
135124
Create a Pix charge for R$25.50 to Maria Silva for lunch
136125
```
@@ -149,18 +138,21 @@ Create a Pix charge for R$15 to João for coffee
149138
Creates a new Pix payment charge with QR code.
150139

151140
**Parameters:**
141+
152142
- `amount` (number): Payment amount in BRL (0.01 to 999,999.99)
153143
- `recipientName` (string): Name of the payment recipient (1-100 chars)
154144
- `description` (string, optional): Payment description (max 200 chars)
155145

156146
**Returns:**
147+
157148
- Transaction ID (txid)
158149
- Pix copy-paste code
159150
- QR code image (base64 data URL)
160151
- Expiration timestamp
161152
- Payment details
162153

163154
**Example:**
155+
164156
```typescript
165157
{
166158
"amount": 25.50,
@@ -188,23 +180,19 @@ npm run format
188180
## 🗺️ Roadmap
189181

190182
### Phase 1: MVP ✅
183+
191184
- [x] `createPixCharge` tool
192-
- [x] Efí provider integration
185+
- [x] Static Pix QR code generation
193186
- [x] QR code generation
194187
- [x] Claude Desktop compatibility
195188

196-
### Phase 2: Stability (In Progress)
197-
- [ ] Cielo provider integration
198-
- [ ] Adyen provider integration
199-
- [ ] Automatic fallback logic
200-
- [ ] Enhanced logging and monitoring
189+
### Phase 2: MCP Discovery
201190

202-
### Phase 3: MCP Discovery
203191
- [ ] Register with MCP registry
204192
- [ ] Public deployment at pixmcp.com
205-
- [ ] Documentation and examples
206193

207194
### Phase 4: Tool Expansion
195+
208196
- [ ] `getPixStatus` tool
209197
- [ ] `cancelPixCharge` tool
210198
- [ ] Webhook listener for payment confirmation

docker-compose.yml

Lines changed: 0 additions & 23 deletions
This file was deleted.

mcp_config.example.json

Lines changed: 0 additions & 14 deletions
This file was deleted.

package-lock.json

Lines changed: 8 additions & 4 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

package.json

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "pix-mcp",
3-
"version": "2.0.0",
3+
"version": "2.1.0",
44
"description": "Standalone MCP server for generating static Pix QR codes without external dependencies",
55
"main": "dist/index.js",
66
"type": "module",
@@ -37,7 +37,6 @@
3737
"ai",
3838
"claude",
3939
"model-context-protocol",
40-
"efi",
4140
"gerencianet"
4241
],
4342
"author": "Pix MCP Team",
@@ -75,5 +74,6 @@
7574
},
7675
"publishConfig": {
7776
"access": "public"
78-
}
77+
},
78+
"packageManager": "[email protected]+sha512.6b865ad4b62a1d9842b61d674a393903b871d9244954f652b8842c2b553c72176b278f64c463e52d40fff8aba385c235c8c9ecf5cc7de4fd78b8bb6d49633ab6"
7979
}

railway.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
"buildCommand": "npm install && npm run build"
66
},
77
"deploy": {
8-
"startCommand": "node dist/index.js --http --http-port $PORT",
8+
"startCommand": "MCP_MODE=http NODE_ENV=production node dist/index.js",
99
"restartPolicyType": "ON_FAILURE",
1010
"restartPolicyMaxRetries": 5
1111
}

render.yaml

Lines changed: 0 additions & 21 deletions
This file was deleted.

0 commit comments

Comments
 (0)