@firfi/huly-mcp 0.8.0 → 0.9.0

package/dist/src/mcp/server.js

@@ -1,216 +0,0 @@
-/**
- * MCP Server infrastructure for Huly MCP server.
- *
- * Provides:
- * - McpServer service wrapping @modelcontextprotocol/sdk
- * - Tool registration with JSON Schema from Effect schemas
- * - Transport selection (stdio/HTTP)
- * - Graceful shutdown handling
- *
- * @module
- */
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { ListToolsRequestSchema, CallToolRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { Context, Effect, Layer, Schema, Exit, ParseResult } from "effect";
-import { HulyClient } from "../huly/client.js";
-import { listIssues, getIssue, createIssue, updateIssue, addLabel, } from "../huly/operations/issues.js";
-import { listIssuesParamsJsonSchema, getIssueParamsJsonSchema, createIssueParamsJsonSchema, updateIssueParamsJsonSchema, addLabelParamsJsonSchema, parseListIssuesParams, parseGetIssueParams, parseCreateIssueParams, parseUpdateIssueParams, parseAddLabelParams, } from "../domain/schemas.js";
-import { mapCauseToMcp, createSuccessResponse, createUnknownToolError, toMcpResponse, } from "./error-mapping.js";
-/**
- * MCP server error.
- */
-export class McpServerError extends Schema.TaggedError()("McpServerError", {
-    message: Schema.String,
-    cause: Schema.optional(Schema.Defect),
-}) {
-}
-// --- Tool Definitions ---
-/**
- * Tool definitions for MCP.
- * Maps tool names to their descriptions and JSON schemas.
- */
-export const TOOL_DEFINITIONS = {
-    list_issues: {
-        name: "list_issues",
-        description: "Query Huly issues with optional filters. Returns issues sorted by modification date (newest first). Supports filtering by project, status, assignee, and milestone.",
-        inputSchema: listIssuesParamsJsonSchema,
-    },
-    get_issue: {
-        name: "get_issue",
-        description: "Retrieve full details for a Huly issue including markdown description. Use this to view issue content, comments, or full metadata.",
-        inputSchema: getIssueParamsJsonSchema,
-    },
-    create_issue: {
-        name: "create_issue",
-        description: "Create a new issue in a Huly project. Description supports markdown formatting. Returns the created issue identifier.",
-        inputSchema: createIssueParamsJsonSchema,
-    },
-    update_issue: {
-        name: "update_issue",
-        description: "Update fields on an existing Huly issue. Only provided fields are modified. Description updates support markdown.",
-        inputSchema: updateIssueParamsJsonSchema,
-    },
-    add_issue_label: {
-        name: "add_issue_label",
-        description: "Add a tag/label to a Huly issue. Creates the tag if it doesn't exist in the project.",
-        inputSchema: addLabelParamsJsonSchema,
-    },
-};
-/**
- * MCP Server service tag.
- */
-export class McpServerService extends Context.Tag("@hulymcp/McpServer")() {
-    /**
-     * Create the MCP server layer.
-     * Requires HulyClient to be available.
-     */
-    static layer(config) {
-        return Layer.effect(McpServerService, Effect.gen(function* () {
-            const hulyClient = yield* HulyClient;
-            // Create the MCP server instance using low-level Server API
-            const server = new Server({
-                name: "huly-mcp",
-                version: "1.0.0",
-            }, {
-                capabilities: {
-                    tools: {},
-                },
-            });
-            // Register tool list handler
-            server.setRequestHandler(ListToolsRequestSchema, async () => ({
-                tools: Object.values(TOOL_DEFINITIONS).map((tool) => ({
-                    name: tool.name,
-                    description: tool.description,
-                    inputSchema: tool.inputSchema,
-                })),
-            }));
-            // Register tool call handler
-            server.setRequestHandler(CallToolRequestSchema, async (request) => {
-                const { name, arguments: args } = request.params;
-                const result = await handleToolCall(name, args ?? {}, hulyClient);
-                // Convert internal response to MCP SDK format
-                return toMcpResponse(result);
-            });
-            // Track server state
-            let isRunning = false;
-            const operations = {
-                run: () => Effect.gen(function* () {
-                    if (isRunning) {
-                        return yield* new McpServerError({
-                            message: "MCP server is already running",
-                        });
-                    }
-                    isRunning = true;
-                    // Create and connect transport based on config
-                    if (config.transport === "stdio") {
-                        const transport = new StdioServerTransport();
-                        yield* Effect.tryPromise({
-                            try: () => server.connect(transport),
-                            catch: (e) => new McpServerError({
-                                message: `Failed to connect stdio transport: ${String(e)}`,
-                                cause: e,
-                            }),
-                        });
-                        // Keep running until stopped
-                        yield* Effect.async((resume) => {
-                            // Set up signal handlers for graceful shutdown
-                            const cleanup = () => {
-                                isRunning = false;
-                                resume(Effect.void);
-                            };
-                            process.on("SIGINT", cleanup);
-                            process.on("SIGTERM", cleanup);
-                            // Return cleanup function for when Effect is interrupted
-                            return Effect.sync(() => {
-                                process.off("SIGINT", cleanup);
-                                process.off("SIGTERM", cleanup);
-                            });
-                        });
-                        // Close server on shutdown
-                        yield* Effect.tryPromise({
-                            try: () => server.close(),
-                            catch: (e) => new McpServerError({
-                                message: `Failed to close server: ${String(e)}`,
-                                cause: e,
-                            }),
-                        });
-                    }
-                    else if (config.transport === "http") {
-                        // HTTP transport - for future implementation
-                        // The MCP SDK provides SSE and StreamableHttp transports
-                        return yield* new McpServerError({
-                            message: "HTTP transport not yet implemented",
-                        });
-                    }
-                }),
-                stop: () => Effect.gen(function* () {
-                    if (!isRunning) {
-                        return;
-                    }
-                    isRunning = false;
-                    yield* Effect.tryPromise({
-                        try: () => server.close(),
-                        catch: (e) => new McpServerError({
-                            message: `Failed to stop server: ${String(e)}`,
-                            cause: e,
-                        }),
-                    });
-                }),
-            };
-            return operations;
-        }));
-    }
-    /**
-     * Create a test layer for unit testing.
-     */
-    static testLayer(mockOperations) {
-        const defaultOps = {
-            run: () => Effect.void,
-            stop: () => Effect.void,
-        };
-        return Layer.succeed(McpServerService, { ...defaultOps, ...mockOperations });
-    }
-}
-// --- Tool Handler ---
-/**
- * Handle a tool call by routing to the appropriate domain operation.
- * Returns MCP protocol response with proper error codes.
- */
-async function handleToolCall(toolName, args, hulyClient) {
-    switch (toolName) {
-        case "list_issues":
-            return runToolHandler(toolName, args, parseListIssuesParams, (params) => listIssues(params), hulyClient);
-        case "get_issue":
-            return runToolHandler(toolName, args, parseGetIssueParams, (params) => getIssue(params), hulyClient);
-        case "create_issue":
-            return runToolHandler(toolName, args, parseCreateIssueParams, (params) => createIssue(params), hulyClient);
-        case "update_issue":
-            return runToolHandler(toolName, args, parseUpdateIssueParams, (params) => updateIssue(params), hulyClient);
-        case "add_issue_label":
-            return runToolHandler(toolName, args, parseAddLabelParams, (params) => addLabel(params), hulyClient);
-        default:
-            return createUnknownToolError(toolName);
-    }
-}
-// --- Tool Handler Execution ---
-/**
- * Execute a tool handler with proper error mapping to MCP protocol.
- * Uses the error-mapping module for consistent error transformation.
- */
-async function runToolHandler(toolName, args, parse, operation, hulyClient) {
-    // Parse and validate input
-    const parseResult = await Effect.runPromiseExit(parse(args));
-    if (Exit.isFailure(parseResult)) {
-        return mapCauseToMcp(parseResult.cause, toolName);
-    }
-    const params = parseResult.value;
-    // Execute the operation with HulyClient provided
-    const operationResult = await Effect.runPromiseExit(operation(params).pipe(Effect.provideService(HulyClient, hulyClient)));
-    if (Exit.isFailure(operationResult)) {
-        return mapCauseToMcp(operationResult.cause, toolName);
-    }
-    // Success - create response
-    return createSuccessResponse(operationResult.value);
-}
-//# sourceMappingURL=server.js.map

package/dist/src/mcp/server.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/mcp/server.ts"],"names":[],"mappings":"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"}