@forumviriumhelsinki/podio-mcp 2.3.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 +491 -0
- package/build/__tests__/integration/setup.integration.d.ts +104 -0
- package/build/__tests__/integration/setup.integration.d.ts.map +1 -0
- package/build/__tests__/integration/setup.integration.js +233 -0
- package/build/__tests__/integration/setup.integration.js.map +1 -0
- package/build/__tests__/mock-data/items-mock-data.d.ts +168 -0
- package/build/__tests__/mock-data/items-mock-data.d.ts.map +1 -0
- package/build/__tests__/mock-data/items-mock-data.js +370 -0
- package/build/__tests__/mock-data/items-mock-data.js.map +1 -0
- package/build/__tests__/mock-data/notification-mock-data.d.ts +55 -0
- package/build/__tests__/mock-data/notification-mock-data.d.ts.map +1 -0
- package/build/__tests__/mock-data/notification-mock-data.js +190 -0
- package/build/__tests__/mock-data/notification-mock-data.js.map +1 -0
- package/build/__tests__/mock-data/project-epic-mock-data.d.ts +45 -0
- package/build/__tests__/mock-data/project-epic-mock-data.d.ts.map +1 -0
- package/build/__tests__/mock-data/project-epic-mock-data.js +85 -0
- package/build/__tests__/mock-data/project-epic-mock-data.js.map +1 -0
- package/build/__tests__/mock-data/tasks-mock-data.d.ts +27 -0
- package/build/__tests__/mock-data/tasks-mock-data.d.ts.map +1 -0
- package/build/__tests__/mock-data/tasks-mock-data.js +104 -0
- package/build/__tests__/mock-data/tasks-mock-data.js.map +1 -0
- package/build/__tests__/mock-data/utility-mock-data.d.ts +19 -0
- package/build/__tests__/mock-data/utility-mock-data.d.ts.map +1 -0
- package/build/__tests__/mock-data/utility-mock-data.js +165 -0
- package/build/__tests__/mock-data/utility-mock-data.js.map +1 -0
- package/build/__tests__/setup.d.ts +8 -0
- package/build/__tests__/setup.d.ts.map +1 -0
- package/build/__tests__/setup.js +31 -0
- package/build/__tests__/setup.js.map +1 -0
- package/build/__tests__/utils/test-helpers.d.ts +110 -0
- package/build/__tests__/utils/test-helpers.d.ts.map +1 -0
- package/build/__tests__/utils/test-helpers.js +222 -0
- package/build/__tests__/utils/test-helpers.js.map +1 -0
- package/build/api/podio-api-client.d.ts +364 -0
- package/build/api/podio-api-client.d.ts.map +1 -0
- package/build/api/podio-api-client.js +696 -0
- package/build/api/podio-api-client.js.map +1 -0
- package/build/cache/app-cache.d.ts +77 -0
- package/build/cache/app-cache.d.ts.map +1 -0
- package/build/cache/app-cache.js +230 -0
- package/build/cache/app-cache.js.map +1 -0
- package/build/cache/base-cache-manager.d.ts +149 -0
- package/build/cache/base-cache-manager.d.ts.map +1 -0
- package/build/cache/base-cache-manager.js +312 -0
- package/build/cache/base-cache-manager.js.map +1 -0
- package/build/cache/cache-manager.d.ts +230 -0
- package/build/cache/cache-manager.d.ts.map +1 -0
- package/build/cache/cache-manager.js +362 -0
- package/build/cache/cache-manager.js.map +1 -0
- package/build/cache/cache-test.d.ts +9 -0
- package/build/cache/cache-test.d.ts.map +1 -0
- package/build/cache/cache-test.js +169 -0
- package/build/cache/cache-test.js.map +1 -0
- package/build/cache/index.d.ts +18 -0
- package/build/cache/index.d.ts.map +1 -0
- package/build/cache/index.js +20 -0
- package/build/cache/index.js.map +1 -0
- package/build/cache/migration-helper.d.ts +44 -0
- package/build/cache/migration-helper.d.ts.map +1 -0
- package/build/cache/migration-helper.js +235 -0
- package/build/cache/migration-helper.js.map +1 -0
- package/build/cache/project-epic-cache.d.ts +108 -0
- package/build/cache/project-epic-cache.d.ts.map +1 -0
- package/build/cache/project-epic-cache.js +278 -0
- package/build/cache/project-epic-cache.js.map +1 -0
- package/build/cache/space-members-cache.d.ts +99 -0
- package/build/cache/space-members-cache.d.ts.map +1 -0
- package/build/cache/space-members-cache.js +305 -0
- package/build/cache/space-members-cache.js.map +1 -0
- package/build/cache/storage-adapters.d.ts +100 -0
- package/build/cache/storage-adapters.d.ts.map +1 -0
- package/build/cache/storage-adapters.js +297 -0
- package/build/cache/storage-adapters.js.map +1 -0
- package/build/errors/api-errors.d.ts +52 -0
- package/build/errors/api-errors.d.ts.map +1 -0
- package/build/errors/api-errors.js +86 -0
- package/build/errors/api-errors.js.map +1 -0
- package/build/errors/auth-errors.d.ts +67 -0
- package/build/errors/auth-errors.d.ts.map +1 -0
- package/build/errors/auth-errors.js +114 -0
- package/build/errors/auth-errors.js.map +1 -0
- package/build/errors/base.d.ts +102 -0
- package/build/errors/base.d.ts.map +1 -0
- package/build/errors/base.js +131 -0
- package/build/errors/base.js.map +1 -0
- package/build/errors/cache-errors.d.ts +53 -0
- package/build/errors/cache-errors.d.ts.map +1 -0
- package/build/errors/cache-errors.js +83 -0
- package/build/errors/cache-errors.js.map +1 -0
- package/build/errors/config-errors.d.ts +58 -0
- package/build/errors/config-errors.d.ts.map +1 -0
- package/build/errors/config-errors.js +96 -0
- package/build/errors/config-errors.js.map +1 -0
- package/build/errors/index.d.ts +101 -0
- package/build/errors/index.d.ts.map +1 -0
- package/build/errors/index.js +135 -0
- package/build/errors/index.js.map +1 -0
- package/build/errors/structure-errors.d.ts +89 -0
- package/build/errors/structure-errors.d.ts.map +1 -0
- package/build/errors/structure-errors.js +182 -0
- package/build/errors/structure-errors.js.map +1 -0
- package/build/errors/validation-errors.d.ts +81 -0
- package/build/errors/validation-errors.d.ts.map +1 -0
- package/build/errors/validation-errors.js +169 -0
- package/build/errors/validation-errors.js.map +1 -0
- package/build/fields/field-mapper.d.ts +245 -0
- package/build/fields/field-mapper.d.ts.map +1 -0
- package/build/fields/field-mapper.js +404 -0
- package/build/fields/field-mapper.js.map +1 -0
- package/build/index.d.ts +550 -0
- package/build/index.d.ts.map +1 -0
- package/build/index.js +1527 -0
- package/build/index.js.map +1 -0
- package/build/oauth-helper.d.ts +189 -0
- package/build/oauth-helper.d.ts.map +1 -0
- package/build/oauth-helper.js +422 -0
- package/build/oauth-helper.js.map +1 -0
- package/build/services/app-structure-service.d.ts +49 -0
- package/build/services/app-structure-service.d.ts.map +1 -0
- package/build/services/app-structure-service.js +122 -0
- package/build/services/app-structure-service.js.map +1 -0
- package/build/services/code-execution-service.d.ts +88 -0
- package/build/services/code-execution-service.d.ts.map +1 -0
- package/build/services/code-execution-service.js +342 -0
- package/build/services/code-execution-service.js.map +1 -0
- package/build/services/comment-service.d.ts +66 -0
- package/build/services/comment-service.d.ts.map +1 -0
- package/build/services/comment-service.js +139 -0
- package/build/services/comment-service.js.map +1 -0
- package/build/services/index.d.ts +16 -0
- package/build/services/index.d.ts.map +1 -0
- package/build/services/index.js +15 -0
- package/build/services/index.js.map +1 -0
- package/build/services/item-service.d.ts +104 -0
- package/build/services/item-service.d.ts.map +1 -0
- package/build/services/item-service.js +368 -0
- package/build/services/item-service.js.map +1 -0
- package/build/services/notification-service.d.ts +125 -0
- package/build/services/notification-service.d.ts.map +1 -0
- package/build/services/notification-service.js +321 -0
- package/build/services/notification-service.js.map +1 -0
- package/build/services/project-epic-service.d.ts +73 -0
- package/build/services/project-epic-service.d.ts.map +1 -0
- package/build/services/project-epic-service.js +248 -0
- package/build/services/project-epic-service.js.map +1 -0
- package/build/services/response-formatter.d.ts +190 -0
- package/build/services/response-formatter.d.ts.map +1 -0
- package/build/services/response-formatter.js +1221 -0
- package/build/services/response-formatter.js.map +1 -0
- package/build/services/search-service.d.ts +103 -0
- package/build/services/search-service.d.ts.map +1 -0
- package/build/services/search-service.js +273 -0
- package/build/services/search-service.js.map +1 -0
- package/build/services/task-service.d.ts +70 -0
- package/build/services/task-service.d.ts.map +1 -0
- package/build/services/task-service.js +156 -0
- package/build/services/task-service.js.map +1 -0
- package/build/tools/index.d.ts +8 -0
- package/build/tools/index.d.ts.map +1 -0
- package/build/tools/index.js +8 -0
- package/build/tools/index.js.map +1 -0
- package/build/tools/tool-definitions.d.ts +89 -0
- package/build/tools/tool-definitions.d.ts.map +1 -0
- package/build/tools/tool-definitions.js +1167 -0
- package/build/tools/tool-definitions.js.map +1 -0
- package/build/types/api-types.d.ts +106 -0
- package/build/types/api-types.d.ts.map +1 -0
- package/build/types/api-types.js +11 -0
- package/build/types/api-types.js.map +1 -0
- package/build/types/cache-types.d.ts +52 -0
- package/build/types/cache-types.d.ts.map +1 -0
- package/build/types/cache-types.js +12 -0
- package/build/types/cache-types.js.map +1 -0
- package/build/types/index.d.ts +31 -0
- package/build/types/index.d.ts.map +1 -0
- package/build/types/index.js +25 -0
- package/build/types/index.js.map +1 -0
- package/build/types/notification-types.d.ts +154 -0
- package/build/types/notification-types.d.ts.map +1 -0
- package/build/types/notification-types.js +7 -0
- package/build/types/notification-types.js.map +1 -0
- package/build/types/podio-types.d.ts +250 -0
- package/build/types/podio-types.d.ts.map +1 -0
- package/build/types/podio-types.js +11 -0
- package/build/types/podio-types.js.map +1 -0
- package/build/types/search-types.d.ts +188 -0
- package/build/types/search-types.d.ts.map +1 -0
- package/build/types/search-types.js +43 -0
- package/build/types/search-types.js.map +1 -0
- package/build/utils/debug.d.ts +58 -0
- package/build/utils/debug.d.ts.map +1 -0
- package/build/utils/debug.js +147 -0
- package/build/utils/debug.js.map +1 -0
- package/examples/claude-config-example.json +13 -0
- package/package.json +87 -0
- package/scripts/generate-claude-config.js +107 -0
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Debug utility for conditional logging
|
|
3
|
+
*
|
|
4
|
+
* Provides structured logging with proper log levels and conditional output
|
|
5
|
+
* based on environment configuration.
|
|
6
|
+
*
|
|
7
|
+
* @example
|
|
8
|
+
* ```typescript
|
|
9
|
+
* import { debug } from './utils/debug.js';
|
|
10
|
+
*
|
|
11
|
+
* // Log debug information (only shown when debug is enabled)
|
|
12
|
+
* debug.log('MyService', 'Processing request', { id: 123 });
|
|
13
|
+
*
|
|
14
|
+
* // Log warnings for fallback strategies
|
|
15
|
+
* debug.warn('MyService', 'Using fallback strategy');
|
|
16
|
+
*
|
|
17
|
+
* // Log errors (always shown, with option to reduce detail in production)
|
|
18
|
+
* debug.error('MyService', 'Failed to fetch data', error);
|
|
19
|
+
*
|
|
20
|
+
* // Check if debug mode is enabled
|
|
21
|
+
* if (debug.isEnabled()) {
|
|
22
|
+
* // Perform expensive debug operations
|
|
23
|
+
* }
|
|
24
|
+
* ```
|
|
25
|
+
*
|
|
26
|
+
* Environment Variables:
|
|
27
|
+
* - PODIO_DEBUG=true - Enable debug logging (preferred)
|
|
28
|
+
* - DEBUG=true - Alternative debug flag
|
|
29
|
+
* - NODE_ENV=development - Enable debug in development mode
|
|
30
|
+
*/
|
|
31
|
+
/**
|
|
32
|
+
* Check if debug mode is enabled
|
|
33
|
+
* Priority: PODIO_DEBUG > DEBUG > NODE_ENV
|
|
34
|
+
*/
|
|
35
|
+
function isDebugEnabled() {
|
|
36
|
+
return (process.env.PODIO_DEBUG === 'true' ||
|
|
37
|
+
process.env.DEBUG === 'true' ||
|
|
38
|
+
process.env.NODE_ENV === 'development');
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Sanitize sensitive data from objects before logging
|
|
42
|
+
* Removes or masks potentially sensitive fields
|
|
43
|
+
*/
|
|
44
|
+
function sanitizeForLogging(data) {
|
|
45
|
+
if (!data || typeof data !== 'object') {
|
|
46
|
+
return data;
|
|
47
|
+
}
|
|
48
|
+
// List of field names that might contain sensitive data
|
|
49
|
+
const sensitiveFields = ['token', 'secret', 'password', 'api_key', 'auth', 'credentials'];
|
|
50
|
+
const sanitized = Array.isArray(data) ? [...data] : { ...data };
|
|
51
|
+
for (const key in sanitized) {
|
|
52
|
+
if (Object.hasOwn(sanitized, key)) {
|
|
53
|
+
const lowerKey = key.toLowerCase();
|
|
54
|
+
// Check if this field name suggests sensitive data
|
|
55
|
+
if (sensitiveFields.some((field) => lowerKey.includes(field))) {
|
|
56
|
+
sanitized[key] = '[REDACTED]';
|
|
57
|
+
}
|
|
58
|
+
else if (typeof sanitized[key] === 'object') {
|
|
59
|
+
// Recursively sanitize nested objects
|
|
60
|
+
sanitized[key] = sanitizeForLogging(sanitized[key]);
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
return sanitized;
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* Debug logger with conditional output
|
|
68
|
+
*/
|
|
69
|
+
export const debug = {
|
|
70
|
+
/**
|
|
71
|
+
* Log debug information (diagnostic data, field discovery, etc.)
|
|
72
|
+
*/
|
|
73
|
+
log(prefix, message, data) {
|
|
74
|
+
if (isDebugEnabled()) {
|
|
75
|
+
const formattedMessage = `[${prefix}] ${message}`;
|
|
76
|
+
if (data !== undefined) {
|
|
77
|
+
const sanitizedData = sanitizeForLogging(data);
|
|
78
|
+
console.debug(formattedMessage, sanitizedData);
|
|
79
|
+
}
|
|
80
|
+
else {
|
|
81
|
+
console.debug(formattedMessage);
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
},
|
|
85
|
+
/**
|
|
86
|
+
* Log informational messages (important operational info)
|
|
87
|
+
*/
|
|
88
|
+
info(prefix, message, data) {
|
|
89
|
+
if (isDebugEnabled()) {
|
|
90
|
+
const formattedMessage = `[${prefix}] ${message}`;
|
|
91
|
+
if (data !== undefined) {
|
|
92
|
+
const sanitizedData = sanitizeForLogging(data);
|
|
93
|
+
console.log(formattedMessage, sanitizedData);
|
|
94
|
+
}
|
|
95
|
+
else {
|
|
96
|
+
console.log(formattedMessage);
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
},
|
|
100
|
+
/**
|
|
101
|
+
* Log warnings (potential issues, fallback strategies used)
|
|
102
|
+
*/
|
|
103
|
+
warn(prefix, message, data) {
|
|
104
|
+
if (isDebugEnabled()) {
|
|
105
|
+
const formattedMessage = `[${prefix}] ${message}`;
|
|
106
|
+
if (data !== undefined) {
|
|
107
|
+
const sanitizedData = sanitizeForLogging(data);
|
|
108
|
+
console.warn(formattedMessage, sanitizedData);
|
|
109
|
+
}
|
|
110
|
+
else {
|
|
111
|
+
console.warn(formattedMessage);
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
},
|
|
115
|
+
/**
|
|
116
|
+
* Log errors (actual errors that need attention)
|
|
117
|
+
* In production: logs message only
|
|
118
|
+
* In debug mode: logs full error details
|
|
119
|
+
*/
|
|
120
|
+
error(prefix, message, error) {
|
|
121
|
+
const formattedMessage = `[${prefix}] ${message}`;
|
|
122
|
+
if (isDebugEnabled()) {
|
|
123
|
+
// In debug mode, show sanitized error details
|
|
124
|
+
if (error !== undefined) {
|
|
125
|
+
const sanitizedError = sanitizeForLogging(error);
|
|
126
|
+
console.error(formattedMessage, sanitizedError);
|
|
127
|
+
}
|
|
128
|
+
else {
|
|
129
|
+
console.error(formattedMessage);
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
else {
|
|
133
|
+
// In production, show only the message to avoid exposing sensitive data
|
|
134
|
+
console.error(formattedMessage);
|
|
135
|
+
if (error && error.message) {
|
|
136
|
+
console.error(`[${prefix}] Error: ${error.message}`);
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
},
|
|
140
|
+
/**
|
|
141
|
+
* Check if debug mode is enabled
|
|
142
|
+
*/
|
|
143
|
+
isEnabled() {
|
|
144
|
+
return isDebugEnabled();
|
|
145
|
+
},
|
|
146
|
+
};
|
|
147
|
+
//# sourceMappingURL=debug.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../src/utils/debug.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
{
|
|
2
|
+
"mcpServers": {
|
|
3
|
+
"podio": {
|
|
4
|
+
"command": "npx",
|
|
5
|
+
"args": ["@forumviriumhelsinki/podio-mcp"],
|
|
6
|
+
"env": {
|
|
7
|
+
"PODIO_CLIENT_ID": "your_podio_client_id_here",
|
|
8
|
+
"PODIO_CLIENT_SECRET": "your_podio_client_secret_here",
|
|
9
|
+
"PODIO_REDIRECT_URI": "http://localhost:8080/callback"
|
|
10
|
+
}
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
}
|
package/package.json
ADDED
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@forumviriumhelsinki/podio-mcp",
|
|
3
|
+
"version": "2.3.0",
|
|
4
|
+
"description": "Model Context Protocol server for Podio item and task management with AI-powered project/epic suggestions",
|
|
5
|
+
"main": "build/index.js",
|
|
6
|
+
"type": "module",
|
|
7
|
+
"publishConfig": {
|
|
8
|
+
"access": "public"
|
|
9
|
+
},
|
|
10
|
+
"repository": {
|
|
11
|
+
"type": "git",
|
|
12
|
+
"url": "https://github.com/forumviriumhelsinki/podio-mcp.git"
|
|
13
|
+
},
|
|
14
|
+
"homepage": "https://github.com/forumviriumhelsinki/podio-mcp#readme",
|
|
15
|
+
"bugs": {
|
|
16
|
+
"url": "https://github.com/forumviriumhelsinki/podio-mcp/issues"
|
|
17
|
+
},
|
|
18
|
+
"scripts": {
|
|
19
|
+
"build": "tsc && chmod +x build/index.js",
|
|
20
|
+
"dev": "tsc --watch",
|
|
21
|
+
"start": "node build/index.js",
|
|
22
|
+
"lint": "biome check .",
|
|
23
|
+
"lint:fix": "biome check --write .",
|
|
24
|
+
"format": "biome format --write .",
|
|
25
|
+
"format:check": "biome format .",
|
|
26
|
+
"check": "biome ci .",
|
|
27
|
+
"test": "jest",
|
|
28
|
+
"test:watch": "jest --watch",
|
|
29
|
+
"test:coverage": "jest --coverage",
|
|
30
|
+
"test:debug": "node --inspect-brk node_modules/.bin/jest --runInBand",
|
|
31
|
+
"test:unit": "jest --testPathPattern='__tests__/(?!integration|e2e)'",
|
|
32
|
+
"test:integration": "jest --config jest.integration.config.js",
|
|
33
|
+
"test:integration:watch": "jest --config jest.integration.config.js --watch",
|
|
34
|
+
"test:integration:coverage": "jest --config jest.integration.config.js --coverage",
|
|
35
|
+
"test:e2e": "jest --config jest.integration.config.js --testPathPattern='e2e'",
|
|
36
|
+
"test:all": "bun run test:unit && bun run test:integration",
|
|
37
|
+
"configure": "node scripts/generate-claude-config.js",
|
|
38
|
+
"docs": "typedoc",
|
|
39
|
+
"docs:serve": "typedoc --watch",
|
|
40
|
+
"docs:build": "bun run build && bun run docs",
|
|
41
|
+
"docs:deploy": "bun run docs:build && echo 'Documentation built successfully. Push to main branch to deploy to GitHub Pages.'",
|
|
42
|
+
"prepublishOnly": "bun run build"
|
|
43
|
+
},
|
|
44
|
+
"bin": {
|
|
45
|
+
"podio-mcp": "build/index.js"
|
|
46
|
+
},
|
|
47
|
+
"dependencies": {
|
|
48
|
+
"@modelcontextprotocol/sdk": "^0.4.0",
|
|
49
|
+
"dotenv": "^17.2.2",
|
|
50
|
+
"node-fetch": "^3.3.2"
|
|
51
|
+
},
|
|
52
|
+
"devDependencies": {
|
|
53
|
+
"@biomejs/biome": "^2.3.10",
|
|
54
|
+
"@types/jest": "^30.0.0",
|
|
55
|
+
"@types/node": "^20.19.0",
|
|
56
|
+
"jest": "^30.0.5",
|
|
57
|
+
"ts-jest": "^29.4.1",
|
|
58
|
+
"typedoc": "^0.25.4",
|
|
59
|
+
"typedoc-plugin-markdown": "^3.17.1",
|
|
60
|
+
"typescript": "^5.4.5"
|
|
61
|
+
},
|
|
62
|
+
"keywords": [
|
|
63
|
+
"mcp",
|
|
64
|
+
"model-context-protocol",
|
|
65
|
+
"podio",
|
|
66
|
+
"items",
|
|
67
|
+
"tasks",
|
|
68
|
+
"tickets",
|
|
69
|
+
"project-management",
|
|
70
|
+
"claude",
|
|
71
|
+
"ai",
|
|
72
|
+
"automation"
|
|
73
|
+
],
|
|
74
|
+
"author": "Lauri Gates",
|
|
75
|
+
"license": "MIT",
|
|
76
|
+
"engines": {
|
|
77
|
+
"node": ">=18.0.0",
|
|
78
|
+
"bun": ">=1.0.0"
|
|
79
|
+
},
|
|
80
|
+
"files": [
|
|
81
|
+
"build/",
|
|
82
|
+
"examples/",
|
|
83
|
+
"scripts/generate-claude-config.js",
|
|
84
|
+
"README.md",
|
|
85
|
+
"LICENSE"
|
|
86
|
+
]
|
|
87
|
+
}
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
import { execSync } from 'child_process';
|
|
4
|
+
import fs from 'fs';
|
|
5
|
+
import path from 'path';
|
|
6
|
+
import os from 'os';
|
|
7
|
+
import { fileURLToPath } from 'url';
|
|
8
|
+
|
|
9
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
10
|
+
const __dirname = path.dirname(__filename);
|
|
11
|
+
|
|
12
|
+
// Get node executable path for local development configuration
|
|
13
|
+
function getNodePath() {
|
|
14
|
+
try {
|
|
15
|
+
if (process.platform === 'win32') {
|
|
16
|
+
return execSync('where node').toString().trim().split('\n')[0];
|
|
17
|
+
} else {
|
|
18
|
+
return execSync('which node').toString().trim();
|
|
19
|
+
}
|
|
20
|
+
} catch (error) {
|
|
21
|
+
console.error('Error finding Node.js path:', error.message);
|
|
22
|
+
console.error('Please make sure Node.js is installed and in your PATH');
|
|
23
|
+
process.exit(1);
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
// Get the path to the built index.js file for local development
|
|
28
|
+
function getIndexJsPath() {
|
|
29
|
+
const projectRoot = process.cwd();
|
|
30
|
+
const indexJsPath = path.join(projectRoot, 'build', 'index.js');
|
|
31
|
+
|
|
32
|
+
if (!fs.existsSync(indexJsPath)) {
|
|
33
|
+
console.error(`Error: ${indexJsPath} not found.`);
|
|
34
|
+
console.error('Please run "bun run build" first to compile the TypeScript code.');
|
|
35
|
+
process.exit(1);
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
return indexJsPath;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
// Generate Claude Desktop configuration
|
|
42
|
+
function generateConfig() {
|
|
43
|
+
const nodePath = getNodePath();
|
|
44
|
+
const indexJsPath = getIndexJsPath();
|
|
45
|
+
|
|
46
|
+
console.log('\n=== Claude Desktop Configuration Generator ===\n');
|
|
47
|
+
console.log(`Node.js path: ${nodePath}`);
|
|
48
|
+
console.log(`Index.js path: ${indexJsPath}\n`);
|
|
49
|
+
|
|
50
|
+
// Get Podio credentials
|
|
51
|
+
console.log('Please enter your Podio credentials:');
|
|
52
|
+
console.log('(Leave blank to use placeholder values that you can edit later)\n');
|
|
53
|
+
|
|
54
|
+
const clientId = process.env.PODIO_CLIENT_ID || 'your_client_id_here';
|
|
55
|
+
const clientSecret = process.env.PODIO_CLIENT_SECRET || 'your_client_secret_here';
|
|
56
|
+
const redirectUri = process.env.PODIO_REDIRECT_URI || 'http://localhost:8080/callback';
|
|
57
|
+
|
|
58
|
+
// Generate configuration JSON
|
|
59
|
+
const config = {
|
|
60
|
+
mcpServers: {
|
|
61
|
+
podio: {
|
|
62
|
+
command: nodePath,
|
|
63
|
+
args: [indexJsPath],
|
|
64
|
+
env: {
|
|
65
|
+
PODIO_CLIENT_ID: clientId,
|
|
66
|
+
PODIO_CLIENT_SECRET: clientSecret,
|
|
67
|
+
PODIO_REDIRECT_URI: redirectUri,
|
|
68
|
+
},
|
|
69
|
+
},
|
|
70
|
+
},
|
|
71
|
+
};
|
|
72
|
+
|
|
73
|
+
// Print the configuration
|
|
74
|
+
console.log('=== Configuration for Claude Desktop ===\n');
|
|
75
|
+
console.log(JSON.stringify(config, null, 2));
|
|
76
|
+
console.log('\n=== Installation Instructions ===');
|
|
77
|
+
|
|
78
|
+
// Determine Claude Desktop config path based on OS
|
|
79
|
+
let configPath;
|
|
80
|
+
if (process.platform === 'darwin') {
|
|
81
|
+
// macOS
|
|
82
|
+
configPath = path.join(
|
|
83
|
+
os.homedir(),
|
|
84
|
+
'Library',
|
|
85
|
+
'Application Support',
|
|
86
|
+
'Claude',
|
|
87
|
+
'claude_desktop_config.json',
|
|
88
|
+
);
|
|
89
|
+
} else if (process.platform === 'win32') {
|
|
90
|
+
// Windows
|
|
91
|
+
configPath = path.join(process.env.APPDATA, 'Claude', 'claude_desktop_config.json');
|
|
92
|
+
} else {
|
|
93
|
+
// Linux and others
|
|
94
|
+
configPath = path.join(os.homedir(), '.config', 'Claude', 'claude_desktop_config.json');
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
console.log(`1. Copy the configuration above`);
|
|
98
|
+
console.log(`2. Paste it into your Claude Desktop configuration file at:\n ${configPath}\n`);
|
|
99
|
+
console.log(` Note: You may need to create this file if it doesn't exist.`);
|
|
100
|
+
console.log(`3. Update any placeholder values with your actual Podio credentials`);
|
|
101
|
+
console.log(`4. Restart Claude Desktop`);
|
|
102
|
+
console.log(
|
|
103
|
+
`5. Start a conversation with Claude and try: "Load app structure for org/space/app" (using your actual coordinates)\n`,
|
|
104
|
+
);
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
generateConfig();
|