backlog-mcp-server 0.8.1 → 0.9.1

package/build/index.js

@@ -18,9 +18,6 @@ import { wrapServerWithToolRegistry } from './utils/wrapServerWithToolRegistry.j
 import packageJson from '../package.json' with { type: 'json' };
 const { version } = packageJson;
 dotenv.config();
-const domain = env.get('BACKLOG_DOMAIN').required().asString();
-const apiKey = env.get('BACKLOG_API_KEY').required().asString();
-const backlog = new backlogjs.Backlog({ host: domain, apiKey: apiKey });
 const argv = yargs(hideBin(process.argv))
     .option('max-tokens', {
     type: 'number',
@@ -60,6 +57,9 @@ Available toolsets:
     default: env.get('ENABLE_DYNAMIC_TOOLSETS').default('false').asBool(),
 })
     .parseSync();
+const domain = env.get('BACKLOG_DOMAIN').required().asString();
+const apiKey = env.get('BACKLOG_API_KEY').required().asString();
+const backlog = new backlogjs.Backlog({ host: domain, apiKey: apiKey });
 const useFields = argv.optimizeResponse;
 const server = wrapServerWithToolRegistry(new McpServer({
     name: 'backlog',

package/build/tools/getUserRecentUpdates.js

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import { buildToolSchema } from '../types/tool.js';
+import { ActivitySchema, ActivityTypeSchema, } from '../types/zod/backlogOutputDefinition.js';
+const getUserRecentUpdatesSchema = buildToolSchema((t) => ({
+    userId: z
+        .number()
+        .describe(t('TOOL_GET_USER_RECENT_UPDATES_USER_ID', 'ID of the user to retrieve activities for')),
+    activityTypeId: z
+        .array(ActivityTypeSchema)
+        .optional()
+        .describe(t('TOOL_GET_USER_RECENT_UPDATES_ACTIVITY_TYPE_ID', 'Activity type IDs to filter by')),
+    minId: z
+        .number()
+        .optional()
+        .describe(t('TOOL_GET_USER_RECENT_UPDATES_MIN_ID', 'Minimum activity ID')),
+    maxId: z
+        .number()
+        .optional()
+        .describe(t('TOOL_GET_USER_RECENT_UPDATES_MAX_ID', 'Maximum activity ID')),
+    count: z
+        .number()
+        .min(1)
+        .max(100)
+        .default(20)
+        .optional()
+        .describe(t('TOOL_GET_USER_RECENT_UPDATES_COUNT', 'Number of activities to retrieve (1-100, default: 20)')),
+    order: z
+        .enum(['asc', 'desc'])
+        .default('desc')
+        .optional()
+        .describe(t('TOOL_GET_USER_RECENT_UPDATES_ORDER', 'Sort order ("asc" or "desc", default: "desc")')),
+}));
+export const getUserRecentUpdatesTool = (backlog, { t }) => {
+    return {
+        name: 'get_user_recent_updates',
+        description: t('TOOL_GET_USER_RECENT_UPDATES_DESCRIPTION', 'Returns recent updates (activities) for a specific user'),
+        schema: z.object(getUserRecentUpdatesSchema(t)),
+        outputSchema: ActivitySchema,
+        importantFields: ['id', 'type', 'content', 'created'],
+        handler: async ({ userId, activityTypeId, minId, maxId, count, order }) => backlog.getUserActivities(userId, {
+            activityTypeId,
+            minId,
+            maxId,
+            count,
+            order,
+        }),
+    };
+};

package/build/tools/getUserStarsCount.js

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { buildToolSchema } from '../types/tool.js';
+import { StarCountSchema } from '../types/zod/backlogOutputDefinition.js';
+const getUserStarsCountSchema = buildToolSchema((t) => ({
+    userId: z
+        .number()
+        .describe(t('TOOL_GET_USER_STARS_COUNT_USER_ID', 'User ID')),
+    since: z
+        .string()
+        .optional()
+        .describe(t('TOOL_GET_USER_STARS_COUNT_SINCE', 'Count stars received after this date (yyyy-MM-dd)')),
+    until: z
+        .string()
+        .optional()
+        .describe(t('TOOL_GET_USER_STARS_COUNT_UNTIL', 'Count stars received before this date (yyyy-MM-dd)')),
+}));
+export const getUserStarsCountTool = (backlog, { t }) => {
+    return {
+        name: 'get_user_stars_count',
+        description: t('TOOL_GET_USER_STARS_COUNT_DESCRIPTION', 'Returns the count of stars received by a user'),
+        schema: z.object(getUserStarsCountSchema(t)),
+        outputSchema: StarCountSchema,
+        handler: async ({ userId, since, until }) => backlog.getUserStarsCount(userId, { since, until }),
+    };
+};

package/build/tools/tools.js

@@ -29,7 +29,9 @@ import { getPullRequestsCountTool } from './getPullRequestsCount.js';
 import { getResolutionsTool } from './getResolutions.js';
 import { getSpaceTool } from './getSpace.js';
 import { getSpaceActivitiesTool } from './getSpaceActivities.js';
+import { getUserStarsCountTool } from './getUserStarsCount.js';
 import { getUsersTool } from './getUsers.js';
+import { getUserRecentUpdatesTool } from './getUserRecentUpdates.js';
 import { getWatchingListCountTool } from './getWatchingListCount.js';
 import { getWatchingListItemsTool } from './getWatchingListItems.js';
 import { addWatchingTool } from './addWatching.js';
@@ -64,7 +66,9 @@ export const allTools = (backlog, helper) => {
                     getSpaceTool(backlog, helper),
                     getSpaceActivitiesTool(backlog, helper),
                     getUsersTool(backlog, helper),
+                    getUserStarsCountTool(backlog, helper),
                     getMyselfTool(backlog, helper),
+                    getUserRecentUpdatesTool(backlog, helper),
                 ],
             },
             {

package/build/types/zod/backlogOutputDefinition.js

@@ -402,6 +402,9 @@ export const SpaceSchema = z.object({
 export const WatchingListCountSchema = z.object({
     count: z.number(),
 });
+export const StarCountSchema = z.object({
+    count: z.number(),
+});
 export const WikiListItemSchema = z.object({
     id: z.number(),
     projectId: z.number(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backlog-mcp-server",
-  "version": "0.8.1",
+  "version": "0.9.1",
   "type": "module",
   "bin": {
     "backlog-mcp-server": "./build/index.js"
@@ -27,7 +27,7 @@
     "build"
   ],
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.24.0",
+    "@modelcontextprotocol/sdk": "^1.26.0",
     "backlog-js": "^0.16.0",
     "cosmiconfig": "^9.0.0",
     "dotenv": "^16.5.0",