@flagdeck/mcp-server 0.1.0
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/LICENSE +21 -0
- package/README.md +468 -0
- package/dist/client.d.ts +76 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/client.js +243 -0
- package/dist/client.js.map +1 -0
- package/dist/index.d.ts +6 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +43 -0
- package/dist/index.js.map +1 -0
- package/dist/server.d.ts +17 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +236 -0
- package/dist/server.js.map +1 -0
- package/dist/setup.d.ts +7 -0
- package/dist/setup.d.ts.map +1 -0
- package/dist/setup.js +144 -0
- package/dist/setup.js.map +1 -0
- package/dist/tools/index.d.ts +28 -0
- package/dist/tools/index.d.ts.map +1 -0
- package/dist/tools/index.js +428 -0
- package/dist/tools/index.js.map +1 -0
- package/dist/types.d.ts +103 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +5 -0
- package/dist/types.js.map +1 -0
- package/package.json +62 -0
package/dist/client.js
ADDED
|
@@ -0,0 +1,243 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Flagdeck API Client
|
|
3
|
+
* Handles communication with the Flagdeck API
|
|
4
|
+
*/
|
|
5
|
+
export class FlagdeckClient {
|
|
6
|
+
config;
|
|
7
|
+
baseHeaders;
|
|
8
|
+
resolvedProjectId;
|
|
9
|
+
resolvedContext;
|
|
10
|
+
constructor(config) {
|
|
11
|
+
this.config = config;
|
|
12
|
+
this.baseHeaders = {
|
|
13
|
+
'X-API-Key': config.apiKey,
|
|
14
|
+
'Content-Type': 'application/json',
|
|
15
|
+
};
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* Resolve project context from the API key at startup.
|
|
19
|
+
* Fetches /sdk/v1/context and caches the projectId for all subsequent calls.
|
|
20
|
+
*/
|
|
21
|
+
async initialize() {
|
|
22
|
+
const context = await this.request('/sdk/v1/context');
|
|
23
|
+
this.resolvedProjectId = context.projectId;
|
|
24
|
+
this.resolvedContext = context;
|
|
25
|
+
return context;
|
|
26
|
+
}
|
|
27
|
+
getResolvedProjectId() {
|
|
28
|
+
return this.resolvedProjectId;
|
|
29
|
+
}
|
|
30
|
+
getContext() {
|
|
31
|
+
return this.resolvedContext;
|
|
32
|
+
}
|
|
33
|
+
async request(path, options = {}) {
|
|
34
|
+
const url = `${this.config.apiUrl}${path}`;
|
|
35
|
+
try {
|
|
36
|
+
const response = await fetch(url, {
|
|
37
|
+
...options,
|
|
38
|
+
headers: {
|
|
39
|
+
...this.baseHeaders,
|
|
40
|
+
...options.headers,
|
|
41
|
+
},
|
|
42
|
+
signal: AbortSignal.timeout(30000), // 30 second timeout
|
|
43
|
+
});
|
|
44
|
+
if (!response.ok) {
|
|
45
|
+
const errorData = await response.json().catch(() => ({}));
|
|
46
|
+
const message = errorData.message || response.statusText;
|
|
47
|
+
throw new Error(`Flagdeck API error: ${response.status} - ${message}`);
|
|
48
|
+
}
|
|
49
|
+
return (await response.json());
|
|
50
|
+
}
|
|
51
|
+
catch (error) {
|
|
52
|
+
if (error.name === 'AbortError') {
|
|
53
|
+
throw new Error('Flagdeck API request timeout (30s)');
|
|
54
|
+
}
|
|
55
|
+
if (error.message.includes('fetch failed')) {
|
|
56
|
+
throw new Error('Flagdeck API unreachable - no response received');
|
|
57
|
+
}
|
|
58
|
+
throw error;
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
// Project Management — resolved from API key context (no JWT required)
|
|
62
|
+
async listProjects() {
|
|
63
|
+
const ctx = this.resolvedContext;
|
|
64
|
+
if (!ctx)
|
|
65
|
+
return [];
|
|
66
|
+
return [{
|
|
67
|
+
id: ctx.projectId,
|
|
68
|
+
name: ctx.projectName,
|
|
69
|
+
slug: ctx.projectSlug,
|
|
70
|
+
key: ctx.projectKey,
|
|
71
|
+
organizationId: ctx.organizationId,
|
|
72
|
+
}];
|
|
73
|
+
}
|
|
74
|
+
async getProject(_projectId) {
|
|
75
|
+
const ctx = await this.initialize();
|
|
76
|
+
return {
|
|
77
|
+
id: ctx.projectId,
|
|
78
|
+
name: ctx.projectName,
|
|
79
|
+
slug: ctx.projectSlug,
|
|
80
|
+
key: ctx.projectKey,
|
|
81
|
+
organizationId: ctx.organizationId,
|
|
82
|
+
};
|
|
83
|
+
}
|
|
84
|
+
// Environment Management — resolved from API key context
|
|
85
|
+
async listEnvironments(_projectId) {
|
|
86
|
+
const ctx = this.resolvedContext;
|
|
87
|
+
if (!ctx || !ctx.environmentId)
|
|
88
|
+
return [];
|
|
89
|
+
return [{
|
|
90
|
+
id: ctx.environmentId,
|
|
91
|
+
key: ctx.environmentKey || '',
|
|
92
|
+
name: ctx.environmentName || '',
|
|
93
|
+
projectId: ctx.projectId,
|
|
94
|
+
}];
|
|
95
|
+
}
|
|
96
|
+
async getEnvironment(_projectId, _environmentKey) {
|
|
97
|
+
const ctx = this.resolvedContext;
|
|
98
|
+
if (!ctx)
|
|
99
|
+
throw new Error('No context resolved');
|
|
100
|
+
return {
|
|
101
|
+
id: ctx.environmentId,
|
|
102
|
+
key: ctx.environmentKey || '',
|
|
103
|
+
name: ctx.environmentName || '',
|
|
104
|
+
projectId: ctx.projectId,
|
|
105
|
+
};
|
|
106
|
+
}
|
|
107
|
+
// Flag Management — uses /sdk/v1/flags (auth via API key, project resolved server-side)
|
|
108
|
+
async listFlags(_projectId, params) {
|
|
109
|
+
// Strip undefined values to avoid sending "?status=undefined" to the API
|
|
110
|
+
const filteredParams = params
|
|
111
|
+
? Object.fromEntries(Object.entries(params).filter(([, v]) => v !== undefined && v !== null))
|
|
112
|
+
: {};
|
|
113
|
+
// Auto-paginate: fetch all pages so Claude always sees the full flag list
|
|
114
|
+
const allFlags = [];
|
|
115
|
+
let page = 1;
|
|
116
|
+
const pageSize = 100; // max allowed by the API
|
|
117
|
+
while (true) {
|
|
118
|
+
const pageParams = { ...filteredParams, page: String(page), pageSize: String(pageSize) };
|
|
119
|
+
const queryString = '?' + new URLSearchParams(pageParams).toString();
|
|
120
|
+
const response = await this.request(`/sdk/v1/flags${queryString}`);
|
|
121
|
+
if (Array.isArray(response)) {
|
|
122
|
+
allFlags.push(...response);
|
|
123
|
+
break; // non-paginated response, done
|
|
124
|
+
}
|
|
125
|
+
const flags = response.data || [];
|
|
126
|
+
allFlags.push(...flags);
|
|
127
|
+
const totalPages = response.meta?.totalPages ?? 1;
|
|
128
|
+
if (page >= totalPages)
|
|
129
|
+
break;
|
|
130
|
+
page++;
|
|
131
|
+
}
|
|
132
|
+
return allFlags;
|
|
133
|
+
}
|
|
134
|
+
async getFlag(_projectId, flagId) {
|
|
135
|
+
return this.request(`/sdk/v1/flags/${flagId}`);
|
|
136
|
+
}
|
|
137
|
+
async getFlagByKey(_projectId, flagKey) {
|
|
138
|
+
return this.request(`/sdk/v1/flags/key/${flagKey}`);
|
|
139
|
+
}
|
|
140
|
+
async createFlag(_projectId, input) {
|
|
141
|
+
return this.request(`/sdk/v1/flags`, {
|
|
142
|
+
method: 'POST',
|
|
143
|
+
body: JSON.stringify(input),
|
|
144
|
+
});
|
|
145
|
+
}
|
|
146
|
+
async updateFlag(_projectId, flagId, input) {
|
|
147
|
+
return this.request(`/sdk/v1/flags/${flagId}`, {
|
|
148
|
+
method: 'PUT',
|
|
149
|
+
body: JSON.stringify(input),
|
|
150
|
+
});
|
|
151
|
+
}
|
|
152
|
+
async deleteFlag(_projectId, flagId) {
|
|
153
|
+
await this.request(`/sdk/v1/flags/${flagId}`, {
|
|
154
|
+
method: 'DELETE',
|
|
155
|
+
});
|
|
156
|
+
}
|
|
157
|
+
async toggleFlag(_projectId, flagId) {
|
|
158
|
+
return this.request(`/sdk/v1/flags/${flagId}/toggle`, {
|
|
159
|
+
method: 'POST',
|
|
160
|
+
});
|
|
161
|
+
}
|
|
162
|
+
async archiveFlag(_projectId, flagId) {
|
|
163
|
+
return this.request(`/sdk/v1/flags/${flagId}/archive`, {
|
|
164
|
+
method: 'POST',
|
|
165
|
+
});
|
|
166
|
+
}
|
|
167
|
+
async setFlagTargeting(_projectId, flagId, input) {
|
|
168
|
+
return this.request(`/sdk/v1/flags/${flagId}/targeting`, {
|
|
169
|
+
method: 'PATCH',
|
|
170
|
+
body: JSON.stringify(input),
|
|
171
|
+
});
|
|
172
|
+
}
|
|
173
|
+
async duplicateFlag(_projectId, flagId, customValues) {
|
|
174
|
+
return this.request(`/sdk/v1/flags/${flagId}/duplicate`, {
|
|
175
|
+
method: 'POST',
|
|
176
|
+
body: JSON.stringify(customValues || {}),
|
|
177
|
+
});
|
|
178
|
+
}
|
|
179
|
+
async bulkArchive(_projectId, flagIds) {
|
|
180
|
+
return this.request(`/sdk/v1/flags/bulk/archive`, {
|
|
181
|
+
method: 'POST',
|
|
182
|
+
body: JSON.stringify({ flagIds }),
|
|
183
|
+
});
|
|
184
|
+
}
|
|
185
|
+
// Flag Evaluation
|
|
186
|
+
async evaluateFlag(flagKey, context, environment) {
|
|
187
|
+
return this.request(`/sdk/v1/evaluate/${flagKey}`, {
|
|
188
|
+
method: 'POST',
|
|
189
|
+
body: JSON.stringify({ context }),
|
|
190
|
+
headers: {
|
|
191
|
+
'X-Environment': environment || this.config.environment || 'production',
|
|
192
|
+
},
|
|
193
|
+
});
|
|
194
|
+
}
|
|
195
|
+
async evaluateBatch(flagKeys, context, environment) {
|
|
196
|
+
return this.request('/sdk/v1/evaluate-batch', {
|
|
197
|
+
method: 'POST',
|
|
198
|
+
body: JSON.stringify({ flagKeys, context }),
|
|
199
|
+
headers: {
|
|
200
|
+
'X-Environment': environment || this.config.environment || 'production',
|
|
201
|
+
},
|
|
202
|
+
});
|
|
203
|
+
}
|
|
204
|
+
// Webhooks
|
|
205
|
+
async listWebhooks(_projectId) {
|
|
206
|
+
const response = await this.request(`/sdk/v1/webhooks`);
|
|
207
|
+
return Array.isArray(response) ? response : (response.data || []);
|
|
208
|
+
}
|
|
209
|
+
async createWebhook(_projectId, input) {
|
|
210
|
+
return this.request(`/sdk/v1/webhooks`, {
|
|
211
|
+
method: 'POST',
|
|
212
|
+
body: JSON.stringify(input),
|
|
213
|
+
});
|
|
214
|
+
}
|
|
215
|
+
async deleteWebhook(_projectId, webhookId) {
|
|
216
|
+
await this.request(`/sdk/v1/webhooks/${webhookId}`, {
|
|
217
|
+
method: 'DELETE',
|
|
218
|
+
});
|
|
219
|
+
}
|
|
220
|
+
async toggleWebhook(_projectId, webhookId) {
|
|
221
|
+
return this.request(`/sdk/v1/webhooks/${webhookId}/toggle`, {
|
|
222
|
+
method: 'POST',
|
|
223
|
+
});
|
|
224
|
+
}
|
|
225
|
+
// Metrics
|
|
226
|
+
async getFlagMetrics(_projectId, flagId) {
|
|
227
|
+
return this.request(`/sdk/v1/metrics/flags/${flagId}`);
|
|
228
|
+
}
|
|
229
|
+
async getProjectMetrics(_projectId) {
|
|
230
|
+
return this.request(`/sdk/v1/metrics/summary`);
|
|
231
|
+
}
|
|
232
|
+
// Health Check
|
|
233
|
+
async healthCheck() {
|
|
234
|
+
try {
|
|
235
|
+
await this.request('/health');
|
|
236
|
+
return true;
|
|
237
|
+
}
|
|
238
|
+
catch {
|
|
239
|
+
return false;
|
|
240
|
+
}
|
|
241
|
+
}
|
|
242
|
+
}
|
|
243
|
+
//# sourceMappingURL=client.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;GAEG"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* Flagdeck MCP Server Entry Point
|
|
4
|
+
*/
|
|
5
|
+
import { FlagdeckMCPServer } from './server.js';
|
|
6
|
+
// Load configuration from environment variables
|
|
7
|
+
function loadConfig() {
|
|
8
|
+
const apiUrl = process.env.FLAGDECK_API_URL || 'https://api.flagdeck.com';
|
|
9
|
+
const apiKey = process.env.FLAGDECK_API_KEY;
|
|
10
|
+
const environment = process.env.FLAGDECK_ENVIRONMENT || 'production';
|
|
11
|
+
if (!apiKey) {
|
|
12
|
+
console.error('Error: FLAGDECK_API_KEY environment variable is required');
|
|
13
|
+
console.error('\nUsage:');
|
|
14
|
+
console.error(' export FLAGDECK_API_KEY=your-api-key');
|
|
15
|
+
console.error(' export FLAGDECK_API_URL=https://api.flagdeck.com # optional');
|
|
16
|
+
console.error(' export FLAGDECK_ENVIRONMENT=production # optional');
|
|
17
|
+
console.error('\n flagdeck-mcp');
|
|
18
|
+
process.exit(1);
|
|
19
|
+
}
|
|
20
|
+
return {
|
|
21
|
+
apiUrl,
|
|
22
|
+
apiKey,
|
|
23
|
+
environment,
|
|
24
|
+
};
|
|
25
|
+
}
|
|
26
|
+
// Start the server
|
|
27
|
+
async function main() {
|
|
28
|
+
try {
|
|
29
|
+
const config = loadConfig();
|
|
30
|
+
const server = new FlagdeckMCPServer(config);
|
|
31
|
+
console.error('Starting Flagdeck MCP Server...');
|
|
32
|
+
console.error(`API URL: ${config.apiUrl}`);
|
|
33
|
+
console.error(`Environment: ${config.environment}`);
|
|
34
|
+
console.error('');
|
|
35
|
+
await server.start();
|
|
36
|
+
}
|
|
37
|
+
catch (error) {
|
|
38
|
+
console.error('Failed to start Flagdeck MCP Server:', error.message);
|
|
39
|
+
process.exit(1);
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
main();
|
|
43
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,gDAAgD;AAChD,SAAS,UAAU;IACjB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,0BAA0B,CAAC;IAC1E,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC5C,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,YAAY,CAAC;IAErE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC1E,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACxD,OAAO,CAAC,KAAK,CAAC,gEAAgE,CAAC,CAAC;QAChF,OAAO,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;QACtE,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO;QACL,MAAM;QACN,MAAM;QACN,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,mBAAmB;AACnB,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAE7C,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACjD,OAAO,CAAC,KAAK,CAAC,YAAY,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3C,OAAO,CAAC,KAAK,CAAC,gBAAgB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAElB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}
|
package/dist/server.d.ts
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Flagdeck MCP Server
|
|
3
|
+
* Implements Model Context Protocol for AI agents to interact with Flagdeck
|
|
4
|
+
*/
|
|
5
|
+
import { FlagdeckConfig } from './types.js';
|
|
6
|
+
export declare class FlagdeckMCPServer {
|
|
7
|
+
private server;
|
|
8
|
+
private client;
|
|
9
|
+
private config;
|
|
10
|
+
constructor(config: FlagdeckConfig);
|
|
11
|
+
private setupHandlers;
|
|
12
|
+
private getTools;
|
|
13
|
+
private executeTool;
|
|
14
|
+
private requiresProjectId;
|
|
15
|
+
start(): Promise<void>;
|
|
16
|
+
}
|
|
17
|
+
//# sourceMappingURL=server.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAiB;gBAEnB,MAAM,EAAE,cAAc;IAkBlC,OAAO,CAAC,aAAa;IA4CrB,OAAO,CAAC,QAAQ;YA0CF,WAAW;IA6IzB,OAAO,CAAC,iBAAiB;IAKnB,KAAK;CAeZ"}
|
package/dist/server.js
ADDED
|
@@ -0,0 +1,236 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Flagdeck MCP Server
|
|
3
|
+
* Implements Model Context Protocol for AI agents to interact with Flagdeck
|
|
4
|
+
*/
|
|
5
|
+
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
|
|
6
|
+
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
|
|
7
|
+
import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
|
|
8
|
+
import { FlagdeckClient } from './client.js';
|
|
9
|
+
import * as tools from './tools/index.js';
|
|
10
|
+
export class FlagdeckMCPServer {
|
|
11
|
+
server;
|
|
12
|
+
client;
|
|
13
|
+
config;
|
|
14
|
+
constructor(config) {
|
|
15
|
+
this.config = config;
|
|
16
|
+
this.client = new FlagdeckClient(config);
|
|
17
|
+
this.server = new Server({
|
|
18
|
+
name: '@flagdeck/mcp-server',
|
|
19
|
+
version: '0.1.0',
|
|
20
|
+
}, {
|
|
21
|
+
capabilities: {
|
|
22
|
+
tools: {},
|
|
23
|
+
},
|
|
24
|
+
});
|
|
25
|
+
this.setupHandlers();
|
|
26
|
+
}
|
|
27
|
+
setupHandlers() {
|
|
28
|
+
// List available tools
|
|
29
|
+
this.server.setRequestHandler(ListToolsRequestSchema, async () => {
|
|
30
|
+
return {
|
|
31
|
+
tools: this.getTools(),
|
|
32
|
+
};
|
|
33
|
+
});
|
|
34
|
+
// Handle tool execution
|
|
35
|
+
this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
|
|
36
|
+
const { name, arguments: args } = request.params;
|
|
37
|
+
try {
|
|
38
|
+
const result = await this.executeTool(name, args || {});
|
|
39
|
+
return {
|
|
40
|
+
content: [
|
|
41
|
+
{
|
|
42
|
+
type: 'text',
|
|
43
|
+
text: JSON.stringify(result, null, 2),
|
|
44
|
+
},
|
|
45
|
+
],
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
catch (error) {
|
|
49
|
+
return {
|
|
50
|
+
content: [
|
|
51
|
+
{
|
|
52
|
+
type: 'text',
|
|
53
|
+
text: JSON.stringify({
|
|
54
|
+
error: error.message,
|
|
55
|
+
tool: name,
|
|
56
|
+
arguments: args,
|
|
57
|
+
}, null, 2),
|
|
58
|
+
},
|
|
59
|
+
],
|
|
60
|
+
isError: true,
|
|
61
|
+
};
|
|
62
|
+
}
|
|
63
|
+
});
|
|
64
|
+
}
|
|
65
|
+
getTools() {
|
|
66
|
+
return [
|
|
67
|
+
// Project & Environment
|
|
68
|
+
tools.listProjectsTool,
|
|
69
|
+
tools.getProjectTool,
|
|
70
|
+
tools.listEnvironmentsTool,
|
|
71
|
+
// Flag Management
|
|
72
|
+
tools.listFlagsTool,
|
|
73
|
+
tools.getFlagTool,
|
|
74
|
+
tools.createFlagTool,
|
|
75
|
+
tools.updateFlagTool,
|
|
76
|
+
tools.deleteFlagTool,
|
|
77
|
+
tools.toggleFlagTool,
|
|
78
|
+
tools.archiveFlagTool,
|
|
79
|
+
// Flag Evaluation
|
|
80
|
+
tools.evaluateFlagTool,
|
|
81
|
+
tools.evaluateBatchTool,
|
|
82
|
+
// Targeting & Rollout
|
|
83
|
+
tools.setFlagTargetingTool,
|
|
84
|
+
// Extended Flag Operations
|
|
85
|
+
tools.duplicateFlagTool,
|
|
86
|
+
tools.bulkArchiveFlagsTool,
|
|
87
|
+
// Webhooks
|
|
88
|
+
tools.listWebhooksTool,
|
|
89
|
+
tools.createWebhookTool,
|
|
90
|
+
tools.deleteWebhookTool,
|
|
91
|
+
tools.toggleWebhookTool,
|
|
92
|
+
// Metrics
|
|
93
|
+
tools.getFlagMetricsTool,
|
|
94
|
+
tools.getProjectMetricsTool,
|
|
95
|
+
// API Key Info
|
|
96
|
+
tools.getApiKeyInfoTool,
|
|
97
|
+
];
|
|
98
|
+
}
|
|
99
|
+
async executeTool(name, args) {
|
|
100
|
+
// Use projectId resolved at startup from the API key context, or from tool args as override
|
|
101
|
+
const projectId = args.projectId || this.client.getResolvedProjectId();
|
|
102
|
+
if (!projectId && this.requiresProjectId(name)) {
|
|
103
|
+
throw new Error(`projectId is required. The API key context could not be resolved at startup. Check your FLAGDECK_API_KEY and FLAGDECK_API_URL.`);
|
|
104
|
+
}
|
|
105
|
+
switch (name) {
|
|
106
|
+
// Project & Environment
|
|
107
|
+
case 'list_projects':
|
|
108
|
+
return await this.client.listProjects();
|
|
109
|
+
case 'get_project':
|
|
110
|
+
return await this.client.getProject(projectId);
|
|
111
|
+
case 'list_environments':
|
|
112
|
+
return await this.client.listEnvironments(projectId);
|
|
113
|
+
// Flag Management
|
|
114
|
+
case 'list_flags':
|
|
115
|
+
return await this.client.listFlags(projectId, {
|
|
116
|
+
status: args.status,
|
|
117
|
+
search: args.search,
|
|
118
|
+
});
|
|
119
|
+
case 'get_flag':
|
|
120
|
+
if (args.flagId) {
|
|
121
|
+
return await this.client.getFlag(projectId, args.flagId);
|
|
122
|
+
}
|
|
123
|
+
else if (args.flagKey) {
|
|
124
|
+
return await this.client.getFlagByKey(projectId, args.flagKey);
|
|
125
|
+
}
|
|
126
|
+
else {
|
|
127
|
+
throw new Error('Either flagId or flagKey must be provided');
|
|
128
|
+
}
|
|
129
|
+
case 'create_flag':
|
|
130
|
+
return await this.client.createFlag(projectId, {
|
|
131
|
+
key: args.key,
|
|
132
|
+
name: args.name,
|
|
133
|
+
description: args.description,
|
|
134
|
+
valueType: args.valueType || 'boolean',
|
|
135
|
+
defaultValue: args.defaultValue ?? false,
|
|
136
|
+
});
|
|
137
|
+
case 'update_flag':
|
|
138
|
+
return await this.client.updateFlag(projectId, args.flagId, {
|
|
139
|
+
name: args.name,
|
|
140
|
+
description: args.description,
|
|
141
|
+
status: args.status,
|
|
142
|
+
defaultValue: args.defaultValue,
|
|
143
|
+
});
|
|
144
|
+
case 'delete_flag':
|
|
145
|
+
await this.client.deleteFlag(projectId, args.flagId);
|
|
146
|
+
return { success: true, message: `Flag ${args.flagId} deleted successfully` };
|
|
147
|
+
case 'toggle_flag':
|
|
148
|
+
return await this.client.toggleFlag(projectId, args.flagId);
|
|
149
|
+
case 'archive_flag':
|
|
150
|
+
return await this.client.archiveFlag(projectId, args.flagId);
|
|
151
|
+
// Flag Evaluation
|
|
152
|
+
case 'evaluate_flag':
|
|
153
|
+
return await this.client.evaluateFlag(args.flagKey, args.context, args.environment);
|
|
154
|
+
case 'evaluate_batch':
|
|
155
|
+
return await this.client.evaluateBatch(args.flagKeys, args.context, args.environment);
|
|
156
|
+
// Targeting & Rollout
|
|
157
|
+
case 'set_flag_targeting':
|
|
158
|
+
return await this.client.setFlagTargeting(projectId, args.flagId, {
|
|
159
|
+
rolloutPercentage: args.rolloutPercentage,
|
|
160
|
+
rules: args.rules,
|
|
161
|
+
useTargeting: args.useTargeting,
|
|
162
|
+
});
|
|
163
|
+
// Extended Flag Operations
|
|
164
|
+
case 'duplicate_flag':
|
|
165
|
+
return await this.client.duplicateFlag(projectId, args.flagId, {
|
|
166
|
+
key: args.key,
|
|
167
|
+
name: args.name,
|
|
168
|
+
description: args.description,
|
|
169
|
+
});
|
|
170
|
+
case 'bulk_archive_flags':
|
|
171
|
+
return await this.client.bulkArchive(projectId, args.flagIds);
|
|
172
|
+
// Webhooks
|
|
173
|
+
case 'list_webhooks':
|
|
174
|
+
return await this.client.listWebhooks(projectId);
|
|
175
|
+
case 'create_webhook':
|
|
176
|
+
return await this.client.createWebhook(projectId, {
|
|
177
|
+
name: args.name,
|
|
178
|
+
url: args.url,
|
|
179
|
+
events: args.events,
|
|
180
|
+
});
|
|
181
|
+
case 'delete_webhook':
|
|
182
|
+
await this.client.deleteWebhook(projectId, args.webhookId);
|
|
183
|
+
return { success: true, message: `Webhook ${args.webhookId} deleted` };
|
|
184
|
+
case 'toggle_webhook':
|
|
185
|
+
return await this.client.toggleWebhook(projectId, args.webhookId);
|
|
186
|
+
// Metrics
|
|
187
|
+
case 'get_flag_metrics':
|
|
188
|
+
return await this.client.getFlagMetrics(projectId, args.flagId);
|
|
189
|
+
case 'get_project_metrics':
|
|
190
|
+
return await this.client.getProjectMetrics(projectId);
|
|
191
|
+
// API Key Info
|
|
192
|
+
case 'get_api_key_info': {
|
|
193
|
+
const ctx = this.client.getContext();
|
|
194
|
+
if (!ctx) {
|
|
195
|
+
throw new Error('API key context not resolved. Check your FLAGDECK_API_KEY and FLAGDECK_API_URL.');
|
|
196
|
+
}
|
|
197
|
+
return {
|
|
198
|
+
project: {
|
|
199
|
+
id: ctx.projectId,
|
|
200
|
+
key: ctx.projectKey,
|
|
201
|
+
name: ctx.projectName,
|
|
202
|
+
slug: ctx.projectSlug,
|
|
203
|
+
},
|
|
204
|
+
environment: ctx.environmentId ? {
|
|
205
|
+
id: ctx.environmentId,
|
|
206
|
+
key: ctx.environmentKey,
|
|
207
|
+
name: ctx.environmentName,
|
|
208
|
+
} : null,
|
|
209
|
+
organizationId: ctx.organizationId,
|
|
210
|
+
};
|
|
211
|
+
}
|
|
212
|
+
default:
|
|
213
|
+
throw new Error(`Unknown tool: ${name}`);
|
|
214
|
+
}
|
|
215
|
+
}
|
|
216
|
+
requiresProjectId(toolName) {
|
|
217
|
+
const noProjectIdTools = ['list_projects', 'get_project', 'get_api_key_info'];
|
|
218
|
+
return !noProjectIdTools.includes(toolName);
|
|
219
|
+
}
|
|
220
|
+
async start() {
|
|
221
|
+
// Resolve project context from the API key before starting
|
|
222
|
+
try {
|
|
223
|
+
const context = await this.client.initialize();
|
|
224
|
+
console.error(`Project: ${context.projectName} (${context.projectKey})`);
|
|
225
|
+
console.error(`Environment: ${context.environmentName || context.environmentKey || 'unknown'}`);
|
|
226
|
+
}
|
|
227
|
+
catch (error) {
|
|
228
|
+
console.error(`Warning: Could not resolve project context - ${error.message}`);
|
|
229
|
+
console.error('Some tools may not work correctly without a resolved project.');
|
|
230
|
+
}
|
|
231
|
+
const transport = new StdioServerTransport();
|
|
232
|
+
await this.server.connect(transport);
|
|
233
|
+
console.error('Flagdeck MCP Server running on stdio');
|
|
234
|
+
}
|
|
235
|
+
}
|
|
236
|
+
//# sourceMappingURL=server.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
|
package/dist/setup.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":";AACA;;;GAGG"}
|