@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.
Files changed (197) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +491 -0
  3. package/build/__tests__/integration/setup.integration.d.ts +104 -0
  4. package/build/__tests__/integration/setup.integration.d.ts.map +1 -0
  5. package/build/__tests__/integration/setup.integration.js +233 -0
  6. package/build/__tests__/integration/setup.integration.js.map +1 -0
  7. package/build/__tests__/mock-data/items-mock-data.d.ts +168 -0
  8. package/build/__tests__/mock-data/items-mock-data.d.ts.map +1 -0
  9. package/build/__tests__/mock-data/items-mock-data.js +370 -0
  10. package/build/__tests__/mock-data/items-mock-data.js.map +1 -0
  11. package/build/__tests__/mock-data/notification-mock-data.d.ts +55 -0
  12. package/build/__tests__/mock-data/notification-mock-data.d.ts.map +1 -0
  13. package/build/__tests__/mock-data/notification-mock-data.js +190 -0
  14. package/build/__tests__/mock-data/notification-mock-data.js.map +1 -0
  15. package/build/__tests__/mock-data/project-epic-mock-data.d.ts +45 -0
  16. package/build/__tests__/mock-data/project-epic-mock-data.d.ts.map +1 -0
  17. package/build/__tests__/mock-data/project-epic-mock-data.js +85 -0
  18. package/build/__tests__/mock-data/project-epic-mock-data.js.map +1 -0
  19. package/build/__tests__/mock-data/tasks-mock-data.d.ts +27 -0
  20. package/build/__tests__/mock-data/tasks-mock-data.d.ts.map +1 -0
  21. package/build/__tests__/mock-data/tasks-mock-data.js +104 -0
  22. package/build/__tests__/mock-data/tasks-mock-data.js.map +1 -0
  23. package/build/__tests__/mock-data/utility-mock-data.d.ts +19 -0
  24. package/build/__tests__/mock-data/utility-mock-data.d.ts.map +1 -0
  25. package/build/__tests__/mock-data/utility-mock-data.js +165 -0
  26. package/build/__tests__/mock-data/utility-mock-data.js.map +1 -0
  27. package/build/__tests__/setup.d.ts +8 -0
  28. package/build/__tests__/setup.d.ts.map +1 -0
  29. package/build/__tests__/setup.js +31 -0
  30. package/build/__tests__/setup.js.map +1 -0
  31. package/build/__tests__/utils/test-helpers.d.ts +110 -0
  32. package/build/__tests__/utils/test-helpers.d.ts.map +1 -0
  33. package/build/__tests__/utils/test-helpers.js +222 -0
  34. package/build/__tests__/utils/test-helpers.js.map +1 -0
  35. package/build/api/podio-api-client.d.ts +364 -0
  36. package/build/api/podio-api-client.d.ts.map +1 -0
  37. package/build/api/podio-api-client.js +696 -0
  38. package/build/api/podio-api-client.js.map +1 -0
  39. package/build/cache/app-cache.d.ts +77 -0
  40. package/build/cache/app-cache.d.ts.map +1 -0
  41. package/build/cache/app-cache.js +230 -0
  42. package/build/cache/app-cache.js.map +1 -0
  43. package/build/cache/base-cache-manager.d.ts +149 -0
  44. package/build/cache/base-cache-manager.d.ts.map +1 -0
  45. package/build/cache/base-cache-manager.js +312 -0
  46. package/build/cache/base-cache-manager.js.map +1 -0
  47. package/build/cache/cache-manager.d.ts +230 -0
  48. package/build/cache/cache-manager.d.ts.map +1 -0
  49. package/build/cache/cache-manager.js +362 -0
  50. package/build/cache/cache-manager.js.map +1 -0
  51. package/build/cache/cache-test.d.ts +9 -0
  52. package/build/cache/cache-test.d.ts.map +1 -0
  53. package/build/cache/cache-test.js +169 -0
  54. package/build/cache/cache-test.js.map +1 -0
  55. package/build/cache/index.d.ts +18 -0
  56. package/build/cache/index.d.ts.map +1 -0
  57. package/build/cache/index.js +20 -0
  58. package/build/cache/index.js.map +1 -0
  59. package/build/cache/migration-helper.d.ts +44 -0
  60. package/build/cache/migration-helper.d.ts.map +1 -0
  61. package/build/cache/migration-helper.js +235 -0
  62. package/build/cache/migration-helper.js.map +1 -0
  63. package/build/cache/project-epic-cache.d.ts +108 -0
  64. package/build/cache/project-epic-cache.d.ts.map +1 -0
  65. package/build/cache/project-epic-cache.js +278 -0
  66. package/build/cache/project-epic-cache.js.map +1 -0
  67. package/build/cache/space-members-cache.d.ts +99 -0
  68. package/build/cache/space-members-cache.d.ts.map +1 -0
  69. package/build/cache/space-members-cache.js +305 -0
  70. package/build/cache/space-members-cache.js.map +1 -0
  71. package/build/cache/storage-adapters.d.ts +100 -0
  72. package/build/cache/storage-adapters.d.ts.map +1 -0
  73. package/build/cache/storage-adapters.js +297 -0
  74. package/build/cache/storage-adapters.js.map +1 -0
  75. package/build/errors/api-errors.d.ts +52 -0
  76. package/build/errors/api-errors.d.ts.map +1 -0
  77. package/build/errors/api-errors.js +86 -0
  78. package/build/errors/api-errors.js.map +1 -0
  79. package/build/errors/auth-errors.d.ts +67 -0
  80. package/build/errors/auth-errors.d.ts.map +1 -0
  81. package/build/errors/auth-errors.js +114 -0
  82. package/build/errors/auth-errors.js.map +1 -0
  83. package/build/errors/base.d.ts +102 -0
  84. package/build/errors/base.d.ts.map +1 -0
  85. package/build/errors/base.js +131 -0
  86. package/build/errors/base.js.map +1 -0
  87. package/build/errors/cache-errors.d.ts +53 -0
  88. package/build/errors/cache-errors.d.ts.map +1 -0
  89. package/build/errors/cache-errors.js +83 -0
  90. package/build/errors/cache-errors.js.map +1 -0
  91. package/build/errors/config-errors.d.ts +58 -0
  92. package/build/errors/config-errors.d.ts.map +1 -0
  93. package/build/errors/config-errors.js +96 -0
  94. package/build/errors/config-errors.js.map +1 -0
  95. package/build/errors/index.d.ts +101 -0
  96. package/build/errors/index.d.ts.map +1 -0
  97. package/build/errors/index.js +135 -0
  98. package/build/errors/index.js.map +1 -0
  99. package/build/errors/structure-errors.d.ts +89 -0
  100. package/build/errors/structure-errors.d.ts.map +1 -0
  101. package/build/errors/structure-errors.js +182 -0
  102. package/build/errors/structure-errors.js.map +1 -0
  103. package/build/errors/validation-errors.d.ts +81 -0
  104. package/build/errors/validation-errors.d.ts.map +1 -0
  105. package/build/errors/validation-errors.js +169 -0
  106. package/build/errors/validation-errors.js.map +1 -0
  107. package/build/fields/field-mapper.d.ts +245 -0
  108. package/build/fields/field-mapper.d.ts.map +1 -0
  109. package/build/fields/field-mapper.js +404 -0
  110. package/build/fields/field-mapper.js.map +1 -0
  111. package/build/index.d.ts +550 -0
  112. package/build/index.d.ts.map +1 -0
  113. package/build/index.js +1527 -0
  114. package/build/index.js.map +1 -0
  115. package/build/oauth-helper.d.ts +189 -0
  116. package/build/oauth-helper.d.ts.map +1 -0
  117. package/build/oauth-helper.js +422 -0
  118. package/build/oauth-helper.js.map +1 -0
  119. package/build/services/app-structure-service.d.ts +49 -0
  120. package/build/services/app-structure-service.d.ts.map +1 -0
  121. package/build/services/app-structure-service.js +122 -0
  122. package/build/services/app-structure-service.js.map +1 -0
  123. package/build/services/code-execution-service.d.ts +88 -0
  124. package/build/services/code-execution-service.d.ts.map +1 -0
  125. package/build/services/code-execution-service.js +342 -0
  126. package/build/services/code-execution-service.js.map +1 -0
  127. package/build/services/comment-service.d.ts +66 -0
  128. package/build/services/comment-service.d.ts.map +1 -0
  129. package/build/services/comment-service.js +139 -0
  130. package/build/services/comment-service.js.map +1 -0
  131. package/build/services/index.d.ts +16 -0
  132. package/build/services/index.d.ts.map +1 -0
  133. package/build/services/index.js +15 -0
  134. package/build/services/index.js.map +1 -0
  135. package/build/services/item-service.d.ts +104 -0
  136. package/build/services/item-service.d.ts.map +1 -0
  137. package/build/services/item-service.js +368 -0
  138. package/build/services/item-service.js.map +1 -0
  139. package/build/services/notification-service.d.ts +125 -0
  140. package/build/services/notification-service.d.ts.map +1 -0
  141. package/build/services/notification-service.js +321 -0
  142. package/build/services/notification-service.js.map +1 -0
  143. package/build/services/project-epic-service.d.ts +73 -0
  144. package/build/services/project-epic-service.d.ts.map +1 -0
  145. package/build/services/project-epic-service.js +248 -0
  146. package/build/services/project-epic-service.js.map +1 -0
  147. package/build/services/response-formatter.d.ts +190 -0
  148. package/build/services/response-formatter.d.ts.map +1 -0
  149. package/build/services/response-formatter.js +1221 -0
  150. package/build/services/response-formatter.js.map +1 -0
  151. package/build/services/search-service.d.ts +103 -0
  152. package/build/services/search-service.d.ts.map +1 -0
  153. package/build/services/search-service.js +273 -0
  154. package/build/services/search-service.js.map +1 -0
  155. package/build/services/task-service.d.ts +70 -0
  156. package/build/services/task-service.d.ts.map +1 -0
  157. package/build/services/task-service.js +156 -0
  158. package/build/services/task-service.js.map +1 -0
  159. package/build/tools/index.d.ts +8 -0
  160. package/build/tools/index.d.ts.map +1 -0
  161. package/build/tools/index.js +8 -0
  162. package/build/tools/index.js.map +1 -0
  163. package/build/tools/tool-definitions.d.ts +89 -0
  164. package/build/tools/tool-definitions.d.ts.map +1 -0
  165. package/build/tools/tool-definitions.js +1167 -0
  166. package/build/tools/tool-definitions.js.map +1 -0
  167. package/build/types/api-types.d.ts +106 -0
  168. package/build/types/api-types.d.ts.map +1 -0
  169. package/build/types/api-types.js +11 -0
  170. package/build/types/api-types.js.map +1 -0
  171. package/build/types/cache-types.d.ts +52 -0
  172. package/build/types/cache-types.d.ts.map +1 -0
  173. package/build/types/cache-types.js +12 -0
  174. package/build/types/cache-types.js.map +1 -0
  175. package/build/types/index.d.ts +31 -0
  176. package/build/types/index.d.ts.map +1 -0
  177. package/build/types/index.js +25 -0
  178. package/build/types/index.js.map +1 -0
  179. package/build/types/notification-types.d.ts +154 -0
  180. package/build/types/notification-types.d.ts.map +1 -0
  181. package/build/types/notification-types.js +7 -0
  182. package/build/types/notification-types.js.map +1 -0
  183. package/build/types/podio-types.d.ts +250 -0
  184. package/build/types/podio-types.d.ts.map +1 -0
  185. package/build/types/podio-types.js +11 -0
  186. package/build/types/podio-types.js.map +1 -0
  187. package/build/types/search-types.d.ts +188 -0
  188. package/build/types/search-types.d.ts.map +1 -0
  189. package/build/types/search-types.js +43 -0
  190. package/build/types/search-types.js.map +1 -0
  191. package/build/utils/debug.d.ts +58 -0
  192. package/build/utils/debug.d.ts.map +1 -0
  193. package/build/utils/debug.js +147 -0
  194. package/build/utils/debug.js.map +1 -0
  195. package/examples/claude-config-example.json +13 -0
  196. package/package.json +87 -0
  197. 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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH;;;GAGG;AACH,SAAS,cAAc;IACrB,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,MAAM;QAClC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM;QAC5B,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,CACvC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CAAC,IAAS;IACnC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wDAAwD;IACxD,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;IAE1F,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC;IAEhE,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;YAEnC,mDAAmD;YACnD,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC9D,SAAS,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;YAChC,CAAC;iBAAM,IAAI,OAAO,SAAS,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC9C,sCAAsC;gBACtC,SAAS,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB;;OAEG;IACH,GAAG,CAAC,MAAc,EAAE,OAAe,EAAE,IAAU;QAC7C,IAAI,cAAc,EAAE,EAAE,CAAC;YACrB,MAAM,gBAAgB,GAAG,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YAClD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,aAAa,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBAC/C,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;YACjD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,MAAc,EAAE,OAAe,EAAE,IAAU;QAC9C,IAAI,cAAc,EAAE,EAAE,CAAC;YACrB,MAAM,gBAAgB,GAAG,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YAClD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,aAAa,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBAC/C,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,MAAc,EAAE,OAAe,EAAE,IAAU;QAC9C,IAAI,cAAc,EAAE,EAAE,CAAC;YACrB,MAAM,gBAAgB,GAAG,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YAClD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,aAAa,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBAC/C,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;YAChD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAc,EAAE,OAAe,EAAE,KAAW;QAChD,MAAM,gBAAgB,GAAG,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QAElD,IAAI,cAAc,EAAE,EAAE,CAAC;YACrB,8CAA8C;YAC9C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,cAAc,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;gBACjD,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;YAClD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,wEAAwE;YACxE,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;YAChC,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC3B,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,cAAc,EAAE,CAAC;IAC1B,CAAC;CACF,CAAC"}
@@ -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();