@meetbot/mcp 1.1.1 → 1.1.2
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.
- package/README.md +45 -41
- package/dist/mcp-server-http.js +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -12,7 +12,7 @@ A Model Context Protocol (MCP) server for the Meet.bot Booking Page API, enablin
|
|
|
12
12
|
- **Health Checks**: Built-in health monitoring using the /v1/pages endpoint
|
|
13
13
|
- **MCP Protocol Compliance**: Full Model Context Protocol server implementation
|
|
14
14
|
- **Dual Mode Support**: Run locally (stdio) or remotely (HTTP/SSE)
|
|
15
|
-
- **Production Deployed**: Live at https://
|
|
15
|
+
- **Production Deployed**: Live at https://mcp.meet.bot
|
|
16
16
|
- **Production Ready**: Thoroughly tested and validated for production use
|
|
17
17
|
|
|
18
18
|
## Installation
|
|
@@ -101,12 +101,11 @@ The MCP server can be run in two modes:
|
|
|
101
101
|
|
|
102
102
|
For local integration with AI assistants like Claude Desktop. Uses stdio transport for communication.
|
|
103
103
|
|
|
104
|
+
**Note**: For stdio mode, you must call the `configure_meetbot` tool first to provide your authentication token. The server does not read environment variables.
|
|
105
|
+
|
|
104
106
|
```bash
|
|
105
107
|
# Run locally
|
|
106
108
|
npx @meetbot/mcp
|
|
107
|
-
|
|
108
|
-
# Or with environment variable
|
|
109
|
-
MEETBOT_AUTH_TOKEN="your_token" npx @meetbot/mcp
|
|
110
109
|
```
|
|
111
110
|
|
|
112
111
|
### 2. HTTP Mode (SSE Transport)
|
|
@@ -123,8 +122,12 @@ npm run start:http
|
|
|
123
122
|
# Or with custom port
|
|
124
123
|
PORT=8080 npm run start:http
|
|
125
124
|
|
|
126
|
-
# Or run directly with npx
|
|
127
|
-
npx meetbot-mcp-http
|
|
125
|
+
# Or run directly with npx (after installing the package)
|
|
126
|
+
npx --package=@meetbot/mcp meetbot-mcp-http
|
|
127
|
+
|
|
128
|
+
# Or install globally first, then run
|
|
129
|
+
npm install -g @meetbot/mcp
|
|
130
|
+
meetbot-mcp-http
|
|
128
131
|
```
|
|
129
132
|
|
|
130
133
|
#### Server Endpoints
|
|
@@ -162,9 +165,9 @@ curl -N -H "Authorization: Bearer YOUR_TOKEN" http://localhost:3000/sse
|
|
|
162
165
|
|
|
163
166
|
**Production Testing:**
|
|
164
167
|
```bash
|
|
165
|
-
# Test the live
|
|
168
|
+
# Test the live deployment
|
|
166
169
|
curl -H "Authorization: Bearer YOUR_TOKEN" \
|
|
167
|
-
https://
|
|
170
|
+
https://mcp.meet.bot/health
|
|
168
171
|
|
|
169
172
|
# Expected response:
|
|
170
173
|
# {"status":"ok","service":"meetbot-mcp"}
|
|
@@ -174,8 +177,7 @@ curl -H "Authorization: Bearer YOUR_TOKEN" \
|
|
|
174
177
|
|
|
175
178
|
The HTTP server can be deployed to various platforms:
|
|
176
179
|
|
|
177
|
-
- **Railway**: `railway up` ✅ **Live at https://
|
|
178
|
-
- **Fly.io**: `fly launch && fly deploy`
|
|
180
|
+
- **Railway**: `railway up` ✅ **Live at https://mcp.meet.bot**
|
|
179
181
|
- **Google Cloud Run**: Container-based deployment
|
|
180
182
|
- **AWS App Runner**: Container-based deployment
|
|
181
183
|
- **Any VPS**: Run with Node.js directly
|
|
@@ -183,7 +185,7 @@ The HTTP server can be deployed to various platforms:
|
|
|
183
185
|
**Example: Connecting to Production**
|
|
184
186
|
```bash
|
|
185
187
|
# Your MCP client should connect to:
|
|
186
|
-
# https://
|
|
188
|
+
# https://mcp.meet.bot/sse
|
|
187
189
|
|
|
188
190
|
# With Authorization header:
|
|
189
191
|
# Authorization: Bearer <your-meetbot-api-token>
|
|
@@ -209,20 +211,29 @@ This MCP server can be integrated with AI assistants like Claude, ChatGPT, and o
|
|
|
209
211
|
|
|
210
212
|
#### Configuration Example
|
|
211
213
|
|
|
214
|
+
For stdio mode, the server will start without authentication. You must call the `configure_meetbot` tool first to provide your token:
|
|
215
|
+
|
|
212
216
|
```json
|
|
213
217
|
{
|
|
214
218
|
"mcpServers": {
|
|
215
219
|
"meetbot": {
|
|
216
220
|
"command": "npx",
|
|
217
|
-
"args": ["@meetbot/mcp"]
|
|
218
|
-
"env": {
|
|
219
|
-
"MEETBOT_AUTH_TOKEN": "your_bearer_token_here"
|
|
220
|
-
}
|
|
221
|
+
"args": ["@meetbot/mcp"]
|
|
221
222
|
}
|
|
222
223
|
}
|
|
223
224
|
}
|
|
224
225
|
```
|
|
225
226
|
|
|
227
|
+
After the server starts, call `configure_meetbot` with your token:
|
|
228
|
+
```json
|
|
229
|
+
{
|
|
230
|
+
"name": "configure_meetbot",
|
|
231
|
+
"arguments": {
|
|
232
|
+
"authToken": "your_bearer_token_here"
|
|
233
|
+
}
|
|
234
|
+
}
|
|
235
|
+
```
|
|
236
|
+
|
|
226
237
|
#### Available MCP Tools
|
|
227
238
|
|
|
228
239
|
The server exposes 6 tools for AI assistants:
|
|
@@ -248,7 +259,7 @@ The package has been thoroughly tested and validated:
|
|
|
248
259
|
### Package Statistics
|
|
249
260
|
|
|
250
261
|
- **Package Size**: 12.8 kB (58.0 kB unpacked)
|
|
251
|
-
- **Test Coverage**:
|
|
262
|
+
- **Test Coverage**: 20 passing tests
|
|
252
263
|
- **Dependencies**: 3 production dependencies
|
|
253
264
|
- **TypeScript**: 100% type coverage
|
|
254
265
|
- **Build Status**: ✅ Passing
|
|
@@ -350,22 +361,13 @@ interface Slots {
|
|
|
350
361
|
|
|
351
362
|
## Configuration
|
|
352
363
|
|
|
353
|
-
### Environment Variables
|
|
354
|
-
|
|
355
|
-
You can configure the MCP server using environment variables:
|
|
356
|
-
|
|
357
|
-
```bash
|
|
358
|
-
export MEETBOT_AUTH_TOKEN="your_bearer_token"
|
|
359
|
-
|
|
360
|
-
# Then run the server
|
|
361
|
-
meetbot-mcp
|
|
362
|
-
```
|
|
363
|
-
|
|
364
364
|
### Authentication
|
|
365
365
|
|
|
366
366
|
The MCP server supports Bearer Token authentication:
|
|
367
367
|
|
|
368
|
-
1. **
|
|
368
|
+
1. **For Stdio Mode**: Call the `configure_meetbot` tool with your `authToken` after the server starts
|
|
369
|
+
2. **For HTTP Mode**: Provide the token in the `Authorization: Bearer <token>` header for all requests
|
|
370
|
+
3. **Bearer Token**: Use `authToken` for API key authentication with the Meet.bot API
|
|
369
371
|
|
|
370
372
|
## Development
|
|
371
373
|
|
|
@@ -391,24 +393,21 @@ The package includes a command-line interface for running the MCP server:
|
|
|
391
393
|
# Install globally
|
|
392
394
|
npm install -g @meetbot/mcp
|
|
393
395
|
|
|
394
|
-
# Run the MCP server
|
|
396
|
+
# Run the MCP server (stdio mode)
|
|
395
397
|
meetbot-mcp
|
|
396
398
|
|
|
397
399
|
# Or run directly with npx (no installation required)
|
|
398
400
|
npx @meetbot/mcp
|
|
399
|
-
```
|
|
400
|
-
|
|
401
|
-
### Environment Variables
|
|
402
401
|
|
|
403
|
-
|
|
402
|
+
# Run HTTP server
|
|
403
|
+
meetbot-mcp-http
|
|
404
404
|
|
|
405
|
-
|
|
406
|
-
|
|
407
|
-
|
|
408
|
-
# Then run the server
|
|
409
|
-
meetbot-mcp
|
|
405
|
+
# Or with custom port
|
|
406
|
+
PORT=8080 meetbot-mcp-http
|
|
410
407
|
```
|
|
411
408
|
|
|
409
|
+
**Note**: For stdio mode, you must call the `configure_meetbot` tool after the server starts to provide your authentication token. For HTTP mode, provide the token in the `Authorization` header.
|
|
410
|
+
|
|
412
411
|
## Error Handling
|
|
413
412
|
|
|
414
413
|
The MCP server provides detailed error messages for common issues:
|
|
@@ -438,17 +437,22 @@ MIT License - see [LICENSE](LICENSE) file for details.
|
|
|
438
437
|
|
|
439
438
|
## Changelog
|
|
440
439
|
|
|
440
|
+
### 1.1.2
|
|
441
|
+
- **Production Host Update**: All docs now reference https://mcp.meet.bot
|
|
442
|
+
- **Deployment Cleanup**: Removed Fly.io deployment instructions
|
|
443
|
+
- **Dev Tooling**: Updated setup script and documentation for the new flow
|
|
444
|
+
|
|
441
445
|
### 1.1.1
|
|
442
446
|
- **ES Module Fix**: Fixed ES module compatibility for Railway and other Node.js deployments
|
|
443
447
|
- **Import Extensions**: Added proper `.js` extensions to all relative imports
|
|
444
|
-
- **Live Deployment**: Successfully deployed
|
|
448
|
+
- **Live Deployment**: Successfully deployed at https://mcp.meet.bot
|
|
445
449
|
- **Production Validated**: Confirmed working in production environment
|
|
446
450
|
|
|
447
451
|
### 1.1.0
|
|
448
452
|
- **HTTP/SSE Transport**: Added HTTP server with SSE transport for remote deployment
|
|
449
453
|
- **Bearer Token Authentication**: Implemented authentication for HTTP endpoints
|
|
450
454
|
- **Multi-mode Support**: Can run as local stdio server or remote HTTP server
|
|
451
|
-
- **Deployment Ready**: Added Dockerfile and deployment configurations for Railway,
|
|
455
|
+
- **Deployment Ready**: Added Dockerfile and deployment configurations for Railway, Docker, GCP, AWS, etc.
|
|
452
456
|
- **Health Check Endpoint**: Added `/health` endpoint for monitoring
|
|
453
457
|
- **Session Management**: Proper session handling with transport cleanup
|
|
454
458
|
- **Production Ready**: Complete HTTP implementation with authentication and error handling
|
|
@@ -483,7 +487,7 @@ MIT License - see [LICENSE](LICENSE) file for details.
|
|
|
483
487
|
- **Error handling** - Robust error handling with detailed messages
|
|
484
488
|
- **Authentication** - Support for bearer token authentication
|
|
485
489
|
- **Health checks** - Built-in API connectivity monitoring using /v1/pages endpoint
|
|
486
|
-
- **Testing** - Comprehensive test suite with
|
|
490
|
+
- **Testing** - Comprehensive test suite with 20 passing tests
|
|
487
491
|
- **Documentation** - Complete API documentation and usage examples
|
|
488
492
|
- **Functional Testing** - Verified with real MCP client requests
|
|
489
493
|
- **npm Publishing** - Successfully published to npm registry
|
package/dist/mcp-server-http.js
CHANGED