@fre4x/github 1.0.30 → 1.0.40

package/src/index.test.ts

@@ -1,246 +0,0 @@
-import { describe, it, expect, beforeAll } from 'vitest';
-import {
-    ListToolsResultSchema,
-    CallToolResultSchema,
-    type TextContent,
-} from '@modelcontextprotocol/sdk/types.js';
-import { server } from './index.js';
-import { Client } from '@modelcontextprotocol/sdk/client/index.js';
-import { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js';
-
-// Ensure mock mode is enabled for tests
-process.env.MOCK = 'true';
-
-describe('GitHub MCP Server', () => {
-    let client: Client;
-    let transport: ReturnType<typeof InMemoryTransport.createLinkedPair>[0];
-
-    beforeAll(async () => {
-        const [_clientTransport, serverTransport] =
-            InMemoryTransport.createLinkedPair();
-        transport = _clientTransport;
-
-        await server.connect(serverTransport);
-
-        client = new Client({
-            name: 'test-client',
-            version: '1.0.0',
-        });
-        await client.connect(transport);
-    });
-
-    describe('Tools', () => {
-        it('should list all available tools', async () => {
-            const response = await client.request(
-                { method: 'tools/list' },
-                ListToolsResultSchema,
-            );
-            expect(response.tools).toBeDefined();
-            expect(response.tools.length).toBe(8);
-
-            const toolNames = response.tools.map((t) => t.name);
-            expect(toolNames).toContain('github_search_repositories');
-            expect(toolNames).toContain('github_search_code');
-            expect(toolNames).toContain('github_search_issues_and_prs');
-            expect(toolNames).toContain('github_get_repository');
-            expect(toolNames).toContain('github_list_issues');
-            expect(toolNames).toContain('github_create_issue');
-            expect(toolNames).toContain('github_get_pull_request');
-            expect(toolNames).toContain('github_list_pull_requests');
-        });
-    });
-
-    describe('Handlers (Mock Mode)', () => {
-        it('handles github_search_repositories', async () => {
-            const response = await client.request(
-                {
-                    method: 'tools/call',
-                    params: {
-                        name: 'github_search_repositories',
-                        arguments: { query: 'mcp-server', limit: 5 },
-                    },
-                },
-                CallToolResultSchema,
-            );
-
-            expect(response.isError).toBeUndefined();
-            expect((response.content[0] as TextContent).text).toContain(
-                'fre4x/mcp-server',
-            );
-        });
-
-        it('handles github_search_code', async () => {
-            const response = await client.request(
-                {
-                    method: 'tools/call',
-                    params: {
-                        name: 'github_search_code',
-                        arguments: { query: 'index.ts', limit: 5 },
-                    },
-                },
-                CallToolResultSchema,
-            );
-
-            expect(response.isError).toBeUndefined();
-            expect((response.content[0] as TextContent).text).toContain(
-                'index.ts',
-            );
-        });
-
-        it('handles github_search_issues_and_prs', async () => {
-            const response = await client.request(
-                {
-                    method: 'tools/call',
-                    params: {
-                        name: 'github_search_issues_and_prs',
-                        arguments: { query: 'mock issue', limit: 5 },
-                    },
-                },
-                CallToolResultSchema,
-            );
-
-            expect(response.isError).toBeUndefined();
-            expect((response.content[0] as TextContent).text).toContain(
-                'Mock issue title',
-            );
-        });
-
-        it('handles github_get_repository', async () => {
-            const response = await client.request(
-                {
-                    method: 'tools/call',
-                    params: {
-                        name: 'github_get_repository',
-                        arguments: { owner: 'fre4x', repo: 'mcp-server' },
-                    },
-                },
-                CallToolResultSchema,
-            );
-
-            expect(response.isError).toBeUndefined();
-            expect((response.content[0] as TextContent).text).toContain(
-                'fre4x/mcp-server',
-            );
-            expect((response.content[0] as TextContent).text).toContain(
-                'Mock repository.',
-            );
-        });
-
-        it('handles github_list_issues', async () => {
-            const response = await client.request(
-                {
-                    method: 'tools/call',
-                    params: {
-                        name: 'github_list_issues',
-                        arguments: { owner: 'fre4x', repo: 'mcp-server' },
-                    },
-                },
-                CallToolResultSchema,
-            );
-
-            expect(response.isError).toBeUndefined();
-            expect((response.content[0] as TextContent).text).toContain(
-                'Fix bug in handler',
-            );
-        });
-
-        it('handles github_create_issue', async () => {
-            const response = await client.request(
-                {
-                    method: 'tools/call',
-                    params: {
-                        name: 'github_create_issue',
-                        arguments: {
-                            owner: 'fre4x',
-                            repo: 'mcp-server',
-                            title: 'New mocked issue',
-                            body: 'test',
-                        },
-                    },
-                },
-                CallToolResultSchema,
-            );
-
-            expect(response.isError).toBeUndefined();
-            expect((response.content[0] as TextContent).text).toContain(
-                'New mocked issue',
-            );
-        });
-
-        it('handles github_get_pull_request', async () => {
-            const response = await client.request(
-                {
-                    method: 'tools/call',
-                    params: {
-                        name: 'github_get_pull_request',
-                        arguments: {
-                            owner: 'fre4x',
-                            repo: 'mcp-server',
-                            pull_number: 4,
-                        },
-                    },
-                },
-                CallToolResultSchema,
-            );
-
-            expect(response.isError).toBeUndefined();
-            expect((response.content[0] as TextContent).text).toContain(
-                'Mock PR title',
-            );
-        });
-
-        it('handles github_list_pull_requests', async () => {
-            const response = await client.request(
-                {
-                    method: 'tools/call',
-                    params: {
-                        name: 'github_list_pull_requests',
-                        arguments: { owner: 'fre4x', repo: 'mcp-server' },
-                    },
-                },
-                CallToolResultSchema,
-            );
-
-            expect(response.isError).toBeUndefined();
-            expect((response.content[0] as TextContent).text).toContain(
-                'Update dependencies',
-            );
-        });
-
-        it('returns validation error for missing required arguments', async () => {
-            const response = await client.request(
-                {
-                    method: 'tools/call',
-                    params: {
-                        name: 'github_get_repository',
-                        arguments: { owner: 'fre4x' }, // Missing repo
-                    },
-                },
-                CallToolResultSchema,
-            );
-
-            expect(response.isError).toBe(true);
-            expect((response.content[0] as TextContent).text).toContain(
-                'Validation Error',
-            );
-        });
-
-        it('returns error for unknown tool', async () => {
-            const response = await client.request(
-                {
-                    method: 'tools/call',
-                    params: {
-                        name: 'unknown_tool',
-                        arguments: {},
-                    },
-                },
-                CallToolResultSchema,
-            );
-
-            expect(response.isError).toBe(true);
-            expect((response.content[0] as TextContent).text).toContain(
-                'Unknown tool',
-            );
-        });
-    });
-});

package/src/index.ts

@@ -1,421 +0,0 @@
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import {
-    CallToolRequestSchema,
-    ListToolsRequestSchema,
-    type Tool,
-    type CallToolResult,
-} from '@modelcontextprotocol/sdk/types.js';
-import * as zod from 'zod';
-// biome-ignore lint/suspicious/noExplicitAny: compatibility pattern
-const z = zod.z || (zod as any).default || zod;
-import { pathToFileURL } from 'node:url';
-import {
-    truncateToLimit,
-    createInternalError,
-    createValidationError,
-    formatMarkdownSection,
-} from '@fre4x/mcp-shared';
-
-import {
-    searchRepositories,
-    searchCode,
-    searchIssuesAndPrs,
-    getRepository,
-    listIssues,
-    createIssue,
-    getPullRequest,
-    listPullRequests,
-} from './api.js';
-
-const server = new Server(
-    {
-        name: '@fre4x/github',
-        version: '1.0.0',
-    },
-    {
-        capabilities: {
-            tools: {},
-        },
-    },
-);
-
-const paginationShape = {
-    limit: z
-        .number()
-        .int()
-        .min(1)
-        .max(100)
-        .default(20)
-        .describe('Maximum number of results to return (1–100, default 20)'),
-    offset: z
-        .number()
-        .int()
-        .min(0)
-        .default(0)
-        .describe('Number of results to skip for pagination (default 0)'),
-};
-
-const searchRepositoriesSchema = z.object({
-    query: z.string().describe('Query to search repositories'),
-    ...paginationShape,
-});
-
-const searchCodeSchema = z.object({
-    query: z.string().describe('Query to search code'),
-    ...paginationShape,
-});
-
-const searchIssuesAndPrsSchema = z.object({
-    query: z.string().describe('Query to search issues and PRs'),
-    ...paginationShape,
-});
-
-const getRepositorySchema = z.object({
-    owner: z.string().describe('Repository owner'),
-    repo: z.string().describe('Repository name'),
-});
-
-const listIssuesSchema = z.object({
-    owner: z.string().describe('Repository owner'),
-    repo: z.string().describe('Repository name'),
-    state: z
-        .enum(['open', 'closed', 'all'])
-        .optional()
-        .describe('State of issues to list'),
-    ...paginationShape,
-});
-
-const createIssueSchema = z.object({
-    owner: z.string().describe('Repository owner'),
-    repo: z.string().describe('Repository name'),
-    title: z.string().describe('Title of the new issue'),
-    body: z.string().optional().describe('Body of the new issue'),
-});
-
-const getPullRequestSchema = z.object({
-    owner: z.string().describe('Repository owner'),
-    repo: z.string().describe('Repository name'),
-    pull_number: z.number().describe('Pull request number'),
-});
-
-const listPullRequestsSchema = z.object({
-    owner: z.string().describe('Repository owner'),
-    repo: z.string().describe('Repository name'),
-    state: z
-        .enum(['open', 'closed', 'all'])
-        .optional()
-        .describe('State of PRs to list'),
-    ...paginationShape,
-});
-
-// --- Tools ---
-const tools: Tool[] = [
-    {
-        name: 'github_search_repositories',
-        description: 'Search for GitHub repositories',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                query: { type: 'string' },
-                limit: { type: 'number' },
-                offset: { type: 'number' },
-            },
-            required: ['query'],
-        },
-    },
-    {
-        name: 'github_search_code',
-        description: 'Search for code within GitHub repositories',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                query: { type: 'string' },
-                limit: { type: 'number' },
-                offset: { type: 'number' },
-            },
-            required: ['query'],
-        },
-    },
-    {
-        name: 'github_search_issues_and_prs',
-        description: 'Search for issues and pull requests',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                query: { type: 'string' },
-                limit: { type: 'number' },
-                offset: { type: 'number' },
-            },
-            required: ['query'],
-        },
-    },
-    {
-        name: 'github_get_repository',
-        description: 'Get details for a specific repository',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                owner: { type: 'string' },
-                repo: { type: 'string' },
-            },
-            required: ['owner', 'repo'],
-        },
-    },
-    {
-        name: 'github_list_issues',
-        description: 'List issues in a specific repository',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                owner: { type: 'string' },
-                repo: { type: 'string' },
-                state: { type: 'string', enum: ['open', 'closed', 'all'] },
-                limit: { type: 'number' },
-                offset: { type: 'number' },
-            },
-            required: ['owner', 'repo'],
-        },
-    },
-    {
-        name: 'github_create_issue',
-        description: 'Create an issue in a repository',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                owner: { type: 'string' },
-                repo: { type: 'string' },
-                title: { type: 'string' },
-                body: { type: 'string' },
-            },
-            required: ['owner', 'repo', 'title'],
-        },
-    },
-    {
-        name: 'github_get_pull_request',
-        description: 'Get details for a specific pull request',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                owner: { type: 'string' },
-                repo: { type: 'string' },
-                pull_number: { type: 'number' },
-            },
-            required: ['owner', 'repo', 'pull_number'],
-        },
-    },
-    {
-        name: 'github_list_pull_requests',
-        description: 'List pull requests in a specific repository',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                owner: { type: 'string' },
-                repo: { type: 'string' },
-                state: { type: 'string', enum: ['open', 'closed', 'all'] },
-                limit: { type: 'number' },
-                offset: { type: 'number' },
-            },
-            required: ['owner', 'repo'],
-        },
-    },
-];
-
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-    return { tools };
-});
-
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    try {
-        switch (request.params.name) {
-            case 'github_search_repositories': {
-                const rawArgs = request.params.arguments ?? {};
-                const args = searchRepositoriesSchema.parse(rawArgs);
-                const limit = args.limit;
-                const offset = args.offset;
-                const result = await searchRepositories({
-                    query: args.query,
-                    limit,
-                    offset,
-                });
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: truncateToLimit(
-                                JSON.stringify(result, null, 2),
-                            ),
-                        },
-                    ],
-                };
-            }
-            case 'github_search_code': {
-                const rawArgs = request.params.arguments ?? {};
-                const args = searchCodeSchema.parse(rawArgs);
-                const limit = args.limit;
-                const offset = args.offset;
-                const result = await searchCode({
-                    query: args.query,
-                    limit,
-                    offset,
-                });
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: truncateToLimit(
-                                JSON.stringify(result, null, 2),
-                            ),
-                        },
-                    ],
-                };
-            }
-            case 'github_search_issues_and_prs': {
-                const rawArgs = request.params.arguments ?? {};
-                const args = searchIssuesAndPrsSchema.parse(rawArgs);
-                const limit = args.limit;
-                const offset = args.offset;
-                const result = await searchIssuesAndPrs({
-                    query: args.query,
-                    limit,
-                    offset,
-                });
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: truncateToLimit(
-                                JSON.stringify(result, null, 2),
-                            ),
-                        },
-                    ],
-                };
-            }
-            case 'github_get_repository': {
-                const rawArgs = request.params.arguments ?? {};
-                const args = getRepositorySchema.parse(rawArgs);
-                const result = await getRepository(args);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: formatMarkdownSection(
-                                result.full_name,
-                                JSON.stringify(result, null, 2),
-                            ),
-                        },
-                    ],
-                };
-            }
-            case 'github_list_issues': {
-                const rawArgs = request.params.arguments ?? {};
-                const args = listIssuesSchema.parse(rawArgs);
-                const limit = args.limit;
-                const offset = args.offset;
-                const result = await listIssues({
-                    owner: args.owner,
-                    repo: args.repo,
-                    state: args.state,
-                    limit,
-                    offset,
-                });
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: truncateToLimit(
-                                JSON.stringify(result, null, 2),
-                            ),
-                        },
-                    ],
-                };
-            }
-            case 'github_create_issue': {
-                const rawArgs = request.params.arguments ?? {};
-                const args = createIssueSchema.parse(rawArgs);
-                const result = await createIssue(args);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: formatMarkdownSection(
-                                result.title,
-                                JSON.stringify(result, null, 2),
-                            ),
-                        },
-                    ],
-                };
-            }
-            case 'github_get_pull_request': {
-                const rawArgs = request.params.arguments ?? {};
-                const args = getPullRequestSchema.parse(rawArgs);
-                const result = await getPullRequest(args);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: formatMarkdownSection(
-                                result.title,
-                                JSON.stringify(result, null, 2),
-                            ),
-                        },
-                    ],
-                };
-            }
-            case 'github_list_pull_requests': {
-                const rawArgs = request.params.arguments ?? {};
-                const args = listPullRequestsSchema.parse(rawArgs);
-                const limit = args.limit;
-                const offset = args.offset;
-                const result = await listPullRequests({
-                    owner: args.owner,
-                    repo: args.repo,
-                    state: args.state,
-                    limit,
-                    offset,
-                });
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: truncateToLimit(
-                                JSON.stringify(result, null, 2),
-                            ),
-                        },
-                    ],
-                };
-            }
-            default:
-                throw new Error(`Unknown tool: ${request.params.name}`);
-        }
-    } catch (error: unknown) {
-        if (error instanceof z.ZodError) {
-            return createValidationError('Arguments', error.message);
-        }
-
-        const isMcpError = (err: unknown): err is CallToolResult =>
-            !!err &&
-            typeof err === 'object' &&
-            'isError' in err &&
-            (err as Record<string, unknown>).isError === true &&
-            'content' in err &&
-            Array.isArray((err as Record<string, unknown>).content);
-
-        if (isMcpError(error)) {
-            return error;
-        }
-        return createInternalError(error);
-    }
-});
-
-async function run() {
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    console.error('GitHub MCP server running on stdio');
-}
-
-if (import.meta.url === pathToFileURL(process.argv[1]).href) {
-    run().catch(console.error);
-}
-
-export { server };

package/tsconfig.json

@@ -1,11 +0,0 @@
-{
-    "extends": "../tsconfig.base.json",
-    "compilerOptions": {
-        "outDir": "./dist",
-        "rootDir": "./src",
-        "module": "NodeNext",
-        "moduleResolution": "NodeNext"
-    },
-    "include": ["src/**/*"],
-    "exclude": ["node_modules", "dist"]
-}