@ldraney/github-mcp 0.1.0 → 0.2.0-beta.1

package/dist/tools/categories/search.d.ts

@@ -1,5 +1,2 @@
-import { Octokit } from '@octokit/rest';
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-export declare const searchTools: Tool[];
-export declare function handleSearchTool(octokit: Octokit, args: Record<string, unknown>): Promise<unknown>;
-//# sourceMappingURL=search.d.ts.map
+import type { ToolCategory } from '../types.js';
+export declare const searchCategory: ToolCategory;

package/dist/tools/categories/search.js

@@ -1,217 +1,315 @@
-export const searchTools = [
-    {
-        name: 'github_search_repos',
-        description: 'Search repositories',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                q: {
-                    type: 'string',
-                    description: 'Search query. Use qualifiers like language:javascript, stars:>1000, user:username',
+import { successResult } from '../types.js';
+export const searchCategory = {
+    name: 'search',
+    description: 'GitHub search tools',
+    tools: [
+        // repos - Search repositories
+        {
+            definition: {
+                name: 'github_search_repos',
+                description: 'Search for repositories on GitHub',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        q: {
+                            type: 'string',
+                            description: 'Search query (e.g., "tetris language:assembly")',
+                        },
+                        sort: {
+                            type: 'string',
+                            enum: ['stars', 'forks', 'help-wanted-issues', 'updated'],
+                            description: 'Sort field',
+                        },
+                        order: {
+                            type: 'string',
+                            enum: ['asc', 'desc'],
+                            description: 'Sort order',
+                        },
+                        per_page: {
+                            type: 'number',
+                            description: 'Results per page (max 100)',
+                        },
+                        page: {
+                            type: 'number',
+                            description: 'Page number',
+                        },
+                    },
+                    required: ['q'],
                 },
-                sort: {
-                    type: 'string',
-                    enum: ['stars', 'forks', 'help-wanted-issues', 'updated'],
-                    description: 'Sort field',
-                },
-                order: {
-                    type: 'string',
-                    enum: ['asc', 'desc'],
-                },
-                per_page: { type: 'number' },
-                page: { type: 'number' },
             },
-            required: ['q'],
+            handler: async (octokit, args) => {
+                const { data } = await octokit.search.repos({
+                    q: args.q,
+                    sort: args.sort,
+                    order: args.order,
+                    per_page: args.per_page,
+                    page: args.page,
+                });
+                return successResult(data);
+            },
         },
-    },
-    {
-        name: 'github_search_code',
-        description: 'Search code in repositories',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                q: {
-                    type: 'string',
-                    description: 'Search query. Use qualifiers like repo:owner/name, language:python, extension:py',
-                },
-                sort: {
-                    type: 'string',
-                    enum: ['indexed'],
-                    description: 'Sort field',
-                },
-                order: {
-                    type: 'string',
-                    enum: ['asc', 'desc'],
+        // code - Search code
+        {
+            definition: {
+                name: 'github_search_code',
+                description: 'Search for code across GitHub repositories',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        q: {
+                            type: 'string',
+                            description: 'Search query (e.g., "addClass in:file language:js repo:jquery/jquery")',
+                        },
+                        sort: {
+                            type: 'string',
+                            enum: ['indexed'],
+                            description: 'Sort field (only indexed is supported)',
+                        },
+                        order: {
+                            type: 'string',
+                            enum: ['asc', 'desc'],
+                            description: 'Sort order',
+                        },
+                        per_page: {
+                            type: 'number',
+                            description: 'Results per page (max 100)',
+                        },
+                        page: {
+                            type: 'number',
+                            description: 'Page number',
+                        },
+                    },
+                    required: ['q'],
                 },
-                per_page: { type: 'number' },
-                page: { type: 'number' },
             },
-            required: ['q'],
+            handler: async (octokit, args) => {
+                const { data } = await octokit.search.code({
+                    q: args.q,
+                    sort: args.sort,
+                    order: args.order,
+                    per_page: args.per_page,
+                    page: args.page,
+                });
+                return successResult(data);
+            },
         },
-    },
-    {
-        name: 'github_search_issues',
-        description: 'Search issues and pull requests',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                q: {
-                    type: 'string',
-                    description: 'Search query. Use qualifiers like repo:owner/name, is:issue, is:pr, state:open, label:bug',
-                },
-                sort: {
-                    type: 'string',
-                    enum: ['comments', 'reactions', 'reactions-+1', 'reactions--1', 'reactions-smile', 'reactions-thinking_face', 'reactions-heart', 'reactions-tada', 'interactions', 'created', 'updated'],
-                },
-                order: {
-                    type: 'string',
-                    enum: ['asc', 'desc'],
+        // issues_and_pull_requests - Search issues and PRs
+        {
+            definition: {
+                name: 'github_search_issues_and_pull_requests',
+                description: 'Search for issues and pull requests across GitHub',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        q: {
+                            type: 'string',
+                            description: 'Search query (e.g., "repo:octocat/hello-world is:open is:issue")',
+                        },
+                        sort: {
+                            type: 'string',
+                            enum: ['comments', 'reactions', 'reactions-+1', 'reactions--1', 'reactions-smile', 'reactions-thinking_face', 'reactions-heart', 'reactions-tada', 'interactions', 'created', 'updated'],
+                            description: 'Sort field',
+                        },
+                        order: {
+                            type: 'string',
+                            enum: ['asc', 'desc'],
+                            description: 'Sort order',
+                        },
+                        per_page: {
+                            type: 'number',
+                            description: 'Results per page (max 100)',
+                        },
+                        page: {
+                            type: 'number',
+                            description: 'Page number',
+                        },
+                    },
+                    required: ['q'],
                 },
-                per_page: { type: 'number' },
-                page: { type: 'number' },
             },
-            required: ['q'],
+            handler: async (octokit, args) => {
+                const { data } = await octokit.search.issuesAndPullRequests({
+                    q: args.q,
+                    sort: args.sort,
+                    order: args.order,
+                    per_page: args.per_page,
+                    page: args.page,
+                });
+                return successResult(data);
+            },
         },
-    },
-    {
-        name: 'github_search_users',
-        description: 'Search users',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                q: {
-                    type: 'string',
-                    description: 'Search query. Use qualifiers like type:user, type:org, location:city, followers:>100',
-                },
-                sort: {
-                    type: 'string',
-                    enum: ['followers', 'repositories', 'joined'],
+        // users - Search users
+        {
+            definition: {
+                name: 'github_search_users',
+                description: 'Search for users on GitHub',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        q: {
+                            type: 'string',
+                            description: 'Search query (e.g., "tom repos:>42 followers:>1000")',
+                        },
+                        sort: {
+                            type: 'string',
+                            enum: ['followers', 'repositories', 'joined'],
+                            description: 'Sort field',
+                        },
+                        order: {
+                            type: 'string',
+                            enum: ['asc', 'desc'],
+                            description: 'Sort order',
+                        },
+                        per_page: {
+                            type: 'number',
+                            description: 'Results per page (max 100)',
+                        },
+                        page: {
+                            type: 'number',
+                            description: 'Page number',
+                        },
+                    },
+                    required: ['q'],
                 },
-                order: {
-                    type: 'string',
-                    enum: ['asc', 'desc'],
-                },
-                per_page: { type: 'number' },
-                page: { type: 'number' },
             },
-            required: ['q'],
+            handler: async (octokit, args) => {
+                const { data } = await octokit.search.users({
+                    q: args.q,
+                    sort: args.sort,
+                    order: args.order,
+                    per_page: args.per_page,
+                    page: args.page,
+                });
+                return successResult(data);
+            },
         },
-    },
-    {
-        name: 'github_search_commits',
-        description: 'Search commits',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                q: {
-                    type: 'string',
-                    description: 'Search query. Use qualifiers like repo:owner/name, author:username, committer:username',
-                },
-                sort: {
-                    type: 'string',
-                    enum: ['author-date', 'committer-date'],
+        // commits - Search commits
+        {
+            definition: {
+                name: 'github_search_commits',
+                description: 'Search for commits across GitHub repositories',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        q: {
+                            type: 'string',
+                            description: 'Search query (e.g., "repo:octocat/hello-world css")',
+                        },
+                        sort: {
+                            type: 'string',
+                            enum: ['author-date', 'committer-date'],
+                            description: 'Sort field',
+                        },
+                        order: {
+                            type: 'string',
+                            enum: ['asc', 'desc'],
+                            description: 'Sort order',
+                        },
+                        per_page: {
+                            type: 'number',
+                            description: 'Results per page (max 100)',
+                        },
+                        page: {
+                            type: 'number',
+                            description: 'Page number',
+                        },
+                    },
+                    required: ['q'],
                 },
-                order: {
-                    type: 'string',
-                    enum: ['asc', 'desc'],
-                },
-                per_page: { type: 'number' },
-                page: { type: 'number' },
             },
-            required: ['q'],
+            handler: async (octokit, args) => {
+                const { data } = await octokit.search.commits({
+                    q: args.q,
+                    sort: args.sort,
+                    order: args.order,
+                    per_page: args.per_page,
+                    page: args.page,
+                });
+                return successResult(data);
+            },
         },
-    },
-    {
-        name: 'github_search_topics',
-        description: 'Search topics',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                q: {
-                    type: 'string',
-                    description: 'Search query for topics',
+        // topics - Search topics
+        {
+            definition: {
+                name: 'github_search_topics',
+                description: 'Search for topics on GitHub',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        q: {
+                            type: 'string',
+                            description: 'Search query (e.g., "ruby is:featured")',
+                        },
+                        per_page: {
+                            type: 'number',
+                            description: 'Results per page (max 100)',
+                        },
+                        page: {
+                            type: 'number',
+                            description: 'Page number',
+                        },
+                    },
+                    required: ['q'],
                 },
-                per_page: { type: 'number' },
-                page: { type: 'number' },
             },
-            required: ['q'],
+            handler: async (octokit, args) => {
+                const { data } = await octokit.search.topics({
+                    q: args.q,
+                    per_page: args.per_page,
+                    page: args.page,
+                });
+                return successResult(data);
+            },
         },
-    },
-    {
-        name: 'github_search_labels',
-        description: 'Search labels in a repository',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                repository_id: { type: 'number', description: 'Repository ID to search in' },
-                q: {
-                    type: 'string',
-                    description: 'Search query for labels',
-                },
-                sort: {
-                    type: 'string',
-                    enum: ['created', 'updated'],
+        // labels - Search labels
+        {
+            definition: {
+                name: 'github_search_labels',
+                description: 'Search for labels in a repository',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        repository_id: {
+                            type: 'number',
+                            description: 'The ID of the repository to search labels in',
+                        },
+                        q: {
+                            type: 'string',
+                            description: 'Search query for label names and descriptions',
+                        },
+                        sort: {
+                            type: 'string',
+                            enum: ['created', 'updated'],
+                            description: 'Sort field',
+                        },
+                        order: {
+                            type: 'string',
+                            enum: ['asc', 'desc'],
+                            description: 'Sort order',
+                        },
+                        per_page: {
+                            type: 'number',
+                            description: 'Results per page (max 100)',
+                        },
+                        page: {
+                            type: 'number',
+                            description: 'Page number',
+                        },
+                    },
+                    required: ['repository_id', 'q'],
                 },
-                order: {
-                    type: 'string',
-                    enum: ['asc', 'desc'],
-                },
-                per_page: { type: 'number' },
-                page: { type: 'number' },
             },
-            required: ['repository_id', 'q'],
+            handler: async (octokit, args) => {
+                const { data } = await octokit.search.labels({
+                    repository_id: args.repository_id,
+                    q: args.q,
+                    sort: args.sort,
+                    order: args.order,
+                    per_page: args.per_page,
+                    page: args.page,
+                });
+                return successResult(data);
+            },
         },
-    },
-];
-export async function handleSearchTool(octokit, args) {
-    const q = args.q;
-    // Determine search type based on args or query content
-    if ('repository_id' in args) {
-        const { data } = await octokit.search.labels(args);
-        return data;
-    }
-    // Check for type hints in the query or sort field
-    const sort = args.sort;
-    if (sort === 'indexed') {
-        const { data } = await octokit.search.code(args);
-        return data;
-    }
-    if (sort === 'author-date' || sort === 'committer-date') {
-        const { data } = await octokit.search.commits(args);
-        return data;
-    }
-    if (sort === 'followers' || sort === 'repositories' || sort === 'joined') {
-        const { data } = await octokit.search.users(args);
-        return data;
-    }
-    if (sort === 'comments' || sort === 'reactions' || sort === 'interactions' || sort?.startsWith('reactions-')) {
-        const { data } = await octokit.search.issuesAndPullRequests(args);
-        return data;
-    }
-    if (sort === 'stars' || sort === 'forks' || sort === 'help-wanted-issues' || sort === 'updated') {
-        const { data } = await octokit.search.repos(args);
-        return data;
-    }
-    // Check query content for hints
-    const lowerQ = q.toLowerCase();
-    if (lowerQ.includes('is:issue') || lowerQ.includes('is:pr') || lowerQ.includes('is:open') || lowerQ.includes('is:closed') || lowerQ.includes('label:')) {
-        const { data } = await octokit.search.issuesAndPullRequests(args);
-        return data;
-    }
-    if (lowerQ.includes('type:user') || lowerQ.includes('type:org') || lowerQ.includes('followers:') || lowerQ.includes('location:')) {
-        const { data } = await octokit.search.users(args);
-        return data;
-    }
-    if (lowerQ.includes('author:') || lowerQ.includes('committer:') || lowerQ.includes('author-date:') || lowerQ.includes('committer-date:')) {
-        const { data } = await octokit.search.commits(args);
-        return data;
-    }
-    if (lowerQ.includes('extension:') || lowerQ.includes('filename:') || lowerQ.includes('path:') || (lowerQ.includes('repo:') && !lowerQ.includes('is:'))) {
-        const { data } = await octokit.search.code(args);
-        return data;
-    }
-    // Default: search repos
-    const { data } = await octokit.search.repos(args);
-    return data;
-}
-//# sourceMappingURL=search.js.map
+    ],
+};

package/dist/tools/categories/secretScanning.d.ts

@@ -0,0 +1,2 @@
+import type { ToolCategory } from '../types.js';
+export declare const secretScanningCategory: ToolCategory;