@granoflow/mcp-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Granoflow
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,203 @@
+# Granoflow MCP Server
+
+MCP server for Granoflow: exposes the Granoflow Local HTTP API as tools for AI
+agents, IDEs, and automation.
+
+This server is intentionally thin. It does not own Granoflow business logic,
+database access, app orchestration, or release workflows. It resolves a local API
+endpoint, forwards structured requests to the running Granoflow app, and returns
+predictable MCP tool results.
+
+## Requirements
+
+- Node.js 20 or newer.
+- A running Granoflow app with the Local HTTP API enabled.
+
+The default Granoflow API URL is:
+
+```text
+http://127.0.0.1:56789
+```
+
+You can override it with:
+
+```bash
+export GRANOFLOW_API_BASE_URL="http://127.0.0.1:56789"
+export GRANOFLOW_API_TOKEN="..."
+```
+
+The MCP server can keep non-secret local connection defaults in:
+
+```text
+~/.config/granoflow-mcp/config.json
+```
+
+Set `GRANOFLOW_MCP_CONFIG_PATH` to use a different config path for tests,
+temporary setups, or advanced local installs. API tokens are not stored in this
+file; keep `GRANOFLOW_API_TOKEN` in the MCP client environment.
+
+## Install
+
+```bash
+npm install -g @granoflow/mcp-server
+```
+
+For local development:
+
+```bash
+npm install
+npm run build
+node dist/index.js
+```
+
+Verify an installed package without starting an MCP stdio session:
+
+```bash
+npx -y @granoflow/mcp-server --version
+npx -y @granoflow/mcp-server --help
+```
+
+Before publishing a release, verify the package contents:
+
+```bash
+npm run check
+npm pack --dry-run
+```
+
+## Tools
+
+Initial tools:
+
+- `granoflow_setup_status`
+- `granoflow_setup_detect_local_api`
+- `granoflow_setup_write_config`
+- `granoflow_setup_open_config`
+- `granoflow_setup_open_app`
+- `granoflow_health`
+- `granoflow_version`
+- `granoflow_capabilities`
+- `granoflow_ai_agent_tools`
+- `granoflow_task_list`
+- `granoflow_task_export`
+- `granoflow_task_validate`
+- `granoflow_task_import`
+- `granoflow_task_create`
+- `granoflow_task_create_structured`
+- `granoflow_task_update`
+- `granoflow_task_update_structured`
+- `granoflow_task_complete`
+- `granoflow_project_list`
+- `granoflow_project_create`
+- `granoflow_project_update`
+- `granoflow_milestone_list`
+- `granoflow_milestone_create`
+- `granoflow_milestone_update`
+- `granoflow_review_day_show`
+- `granoflow_api_request`
+
+Prefer the structured task, project, and milestone tools for common resource
+operations. The JSON payload tools remain available as escape hatches when the
+running app exposes newer fields before this package has first-class schemas.
+
+Write tools default to dry-run behavior. Ask the tool to write only after you
+have reviewed the preview or the user has explicitly requested a write.
+
+## Setup Diagnostics
+
+Use the setup tools when an agent or MCP client needs to connect to a local
+Granoflow app without hand-editing every setting first:
+
+- `granoflow_setup_status` reports config path, env/config precedence, token
+  presence, Local HTTP API health, version metadata, and local Granoflow process
+  evidence without printing secrets.
+- `granoflow_setup_detect_local_api` probes a small bounded localhost port list
+  only.
+- `granoflow_setup_write_config` previews or writes non-secret config. It
+  defaults to dry-run.
+- `granoflow_setup_open_config` creates and optionally opens the config file for
+  manual editing.
+- `granoflow_setup_open_app` previews or opens the installed Granoflow app after
+  user approval. On macOS it tries the formal `/Applications/granoflow.app`
+  path before app-name fallbacks. It defaults to dry-run.
+
+When setup status sees a configured localhost API URL that is unreachable, it
+checks whether a local Granoflow process appears to be running. If not, it
+returns a warning and asks the agent to confirm before opening the app.
+
+## Client Support
+
+This package implements a standard MCP stdio server. The primary compatibility
+contract is the MCP protocol plus the npm executable:
+
+```bash
+npx -y @granoflow/mcp-server
+```
+
+Cursor and Codex are the verified client targets for this repository. Other
+MCP-compatible clients can use the same stdio command shape, but are not part of
+the routine verification matrix.
+
+## Cursor
+
+Add this to `.cursor/mcp.json` in a project or `~/.cursor/mcp.json` globally:
+
+```json
+{
+  "mcpServers": {
+    "granoflow": {
+      "command": "npx",
+      "args": ["-y", "@granoflow/mcp-server"],
+      "env": {
+        "GRANOFLOW_API_BASE_URL": "http://127.0.0.1:56789"
+      }
+    }
+  }
+}
+```
+
+## Codex
+
+Add this to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.granoflow]
+command = "npx"
+args = ["-y", "@granoflow/mcp-server"]
+
+[mcp_servers.granoflow.env]
+GRANOFLOW_API_BASE_URL = "http://127.0.0.1:56789"
+```
+
+Restart Codex after changing MCP configuration.
+
+## Other MCP-Compatible Clients
+
+For clients that support local stdio MCP servers, configure the server with:
+
+```jsonc
+{
+  "type": "stdio",
+  "command": "npx",
+  "args": ["-y", "@granoflow/mcp-server"],
+  "env": {
+    "GRANOFLOW_API_BASE_URL": "http://127.0.0.1:56789",
+  },
+}
+```
+
+## Development
+
+```bash
+npm install
+npm run check
+```
+
+`npm run check` runs Prettier, ESLint, TypeScript, and Vitest.
+
+## Security
+
+- This server does not read or write Granoflow's SQLite/Drift database.
+- This server does not run Granoflow app builds, screenshots, release jobs, or
+  scenario orchestration.
+- Core operations go through the running app's Local HTTP API.
+- API tokens are passed through environment variables and must not be logged.

package/dist/api.d.ts

@@ -0,0 +1,26 @@
+import { type RuntimeResolution } from "./config.js";
+export interface ApiRequestOptions {
+    method?: "GET" | "POST" | "PATCH" | "DELETE";
+    path: string;
+    body?: unknown;
+    dryRun?: boolean;
+}
+export interface ApiResult {
+    ok: boolean;
+    code: string;
+    data?: unknown;
+    error?: {
+        message: string;
+    };
+    httpStatus?: number;
+    runtime: {
+        apiBaseUrl: string;
+        apiBaseUrlSource: RuntimeResolution["apiBaseUrlSource"];
+        apiToken: {
+            present: boolean;
+            source: RuntimeResolution["apiTokenSource"];
+        };
+    };
+}
+export declare function buildApiUrl(apiBaseUrl: string, path: string): URL;
+export declare function requestGranoflowApi(options: ApiRequestOptions, env?: NodeJS.ProcessEnv): Promise<ApiResult>;

package/dist/api.js

@@ -0,0 +1,98 @@
+import { resolveMcpRuntime } from "./config.js";
+function runtimeSummary(runtime) {
+    return {
+        apiBaseUrl: runtime.apiBaseUrl,
+        apiBaseUrlSource: runtime.apiBaseUrlSource,
+        apiToken: {
+            present: runtime.hasApiToken,
+            source: runtime.apiTokenSource,
+        },
+    };
+}
+function pathWithLeadingSlash(path) {
+    return path.startsWith("/") ? path : `/${path}`;
+}
+export function buildApiUrl(apiBaseUrl, path) {
+    return new URL(pathWithLeadingSlash(path), apiBaseUrl.endsWith("/") ? apiBaseUrl : `${apiBaseUrl}/`);
+}
+async function parseResponseBody(response) {
+    const text = await response.text();
+    if (!text.trim()) {
+        return null;
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+export async function requestGranoflowApi(options, env = process.env) {
+    const runtime = await resolveMcpRuntime(env);
+    const method = options.method ?? "GET";
+    const path = pathWithLeadingSlash(options.path);
+    if (options.dryRun) {
+        return {
+            ok: true,
+            code: "dry_run",
+            data: {
+                method,
+                path,
+                body: options.body ?? null,
+                previewMode: "local_request_only",
+            },
+            runtime: runtimeSummary(runtime),
+        };
+    }
+    const headers = new Headers();
+    headers.set("accept", "application/json");
+    if (options.body !== undefined) {
+        headers.set("content-type", "application/json");
+    }
+    if (runtime.apiToken) {
+        headers.set("authorization", `Bearer ${runtime.apiToken}`);
+    }
+    try {
+        const response = await fetch(buildApiUrl(runtime.apiBaseUrl, path), {
+            method,
+            headers,
+            body: options.body === undefined ? undefined : JSON.stringify(options.body),
+        });
+        const body = await parseResponseBody(response);
+        if (!response.ok) {
+            return {
+                ok: false,
+                code: `http_${response.status}`,
+                data: body,
+                error: { message: `Granoflow Local HTTP API returned HTTP ${response.status}.` },
+                httpStatus: response.status,
+                runtime: runtimeSummary(runtime),
+            };
+        }
+        if (typeof body === "object" && body !== null && "ok" in body && "code" in body) {
+            return {
+                ...body,
+                httpStatus: response.status,
+                runtime: runtimeSummary(runtime),
+            };
+        }
+        return {
+            ok: true,
+            code: "ok",
+            data: body,
+            httpStatus: response.status,
+            runtime: runtimeSummary(runtime),
+        };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            code: "network_error",
+            error: {
+                message: error instanceof Error ? error.message : String(error),
+            },
+            runtime: runtimeSummary(runtime),
+        };
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,40 @@
+export interface GranoflowMcpConfig {
+    apiBaseUrl?: string;
+    [key: string]: unknown;
+}
+export interface ConfigReadResult {
+    configPath: string;
+    exists: boolean;
+    config: GranoflowMcpConfig;
+    error?: string;
+}
+export interface RuntimeResolution {
+    configPath: string;
+    configExists: boolean;
+    configError?: string;
+    apiBaseUrl: string;
+    apiBaseUrlSource: "env" | "config" | "default";
+    hasApiToken: boolean;
+    apiTokenSource: "env" | "none";
+    apiToken?: string;
+}
+export interface WriteConfigInput {
+    apiBaseUrl?: string;
+    dryRun?: boolean;
+}
+export interface WriteConfigResult {
+    configPath: string;
+    dryRun: boolean;
+    written: boolean;
+    backupPath: string | null;
+    previousConfig: Record<string, unknown>;
+    nextConfig: Record<string, unknown>;
+    changedKeys: string[];
+    nextActions: string[];
+}
+export declare function getMcpConfigPath(env?: NodeJS.ProcessEnv): string;
+export declare function redactConfig(config: GranoflowMcpConfig): Record<string, unknown>;
+export declare function readMcpConfig(env?: NodeJS.ProcessEnv): Promise<ConfigReadResult>;
+export declare function resolveMcpRuntime(env?: NodeJS.ProcessEnv): Promise<RuntimeResolution>;
+export declare function writeMcpConfig(input: WriteConfigInput, env?: NodeJS.ProcessEnv): Promise<WriteConfigResult>;
+export declare function configFileExists(configPath: string): Promise<boolean>;

package/dist/config.js

@@ -0,0 +1,148 @@
+import { mkdir, open, readFile, rename, stat, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+const SECRET_KEY_PATTERN = /(token|secret|password|credential|key)/i;
+const DEFAULT_API_BASE_URL = "http://127.0.0.1:56789";
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function validateApiBaseUrl(apiBaseUrl) {
+    const url = new URL(apiBaseUrl);
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        throw new Error("apiBaseUrl must use http or https.");
+    }
+}
+function stableJson(value) {
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
+export function getMcpConfigPath(env = process.env) {
+    if (env.GRANOFLOW_MCP_CONFIG_PATH) {
+        return env.GRANOFLOW_MCP_CONFIG_PATH;
+    }
+    if (env.XDG_CONFIG_HOME) {
+        return join(env.XDG_CONFIG_HOME, "granoflow-mcp", "config.json");
+    }
+    return join(homedir(), ".config", "granoflow-mcp", "config.json");
+}
+export function redactConfig(config) {
+    const redacted = {};
+    for (const [key, value] of Object.entries(config)) {
+        redacted[key] = SECRET_KEY_PATTERN.test(key) && value !== undefined ? "[REDACTED]" : value;
+    }
+    return redacted;
+}
+export async function readMcpConfig(env = process.env) {
+    const configPath = getMcpConfigPath(env);
+    try {
+        const text = await readFile(configPath, "utf8");
+        const parsed = JSON.parse(text);
+        if (!isObject(parsed)) {
+            return {
+                configPath,
+                exists: true,
+                config: {},
+                error: "Config file must contain a JSON object.",
+            };
+        }
+        return { configPath, exists: true, config: parsed };
+    }
+    catch (error) {
+        if (isObject(error) && "code" in error && error.code === "ENOENT") {
+            return { configPath, exists: false, config: {} };
+        }
+        return {
+            configPath,
+            exists: false,
+            config: {},
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+export async function resolveMcpRuntime(env = process.env) {
+    const configResult = await readMcpConfig(env);
+    const config = configResult.config;
+    const apiBaseUrl = env.GRANOFLOW_API_BASE_URL ??
+        (typeof config.apiBaseUrl === "string" ? config.apiBaseUrl : undefined) ??
+        DEFAULT_API_BASE_URL;
+    return {
+        configPath: configResult.configPath,
+        configExists: configResult.exists,
+        configError: configResult.error,
+        apiBaseUrl,
+        apiBaseUrlSource: env.GRANOFLOW_API_BASE_URL
+            ? "env"
+            : typeof config.apiBaseUrl === "string"
+                ? "config"
+                : "default",
+        hasApiToken: Boolean(env.GRANOFLOW_API_TOKEN),
+        apiTokenSource: env.GRANOFLOW_API_TOKEN ? "env" : "none",
+        apiToken: env.GRANOFLOW_API_TOKEN,
+    };
+}
+export async function writeMcpConfig(input, env = process.env) {
+    if (input.apiBaseUrl !== undefined) {
+        validateApiBaseUrl(input.apiBaseUrl);
+    }
+    const readResult = await readMcpConfig(env);
+    const nextConfig = { ...readResult.config };
+    if (input.apiBaseUrl !== undefined) {
+        nextConfig.apiBaseUrl = input.apiBaseUrl;
+    }
+    const previousConfig = redactConfig(readResult.config);
+    const redactedNextConfig = redactConfig(nextConfig);
+    const changedKeys = Object.keys(redactedNextConfig).filter((key) => previousConfig[key] !== redactedNextConfig[key]);
+    const dryRun = input.dryRun !== false;
+    if (dryRun) {
+        return {
+            configPath: readResult.configPath,
+            dryRun,
+            written: false,
+            backupPath: null,
+            previousConfig,
+            nextConfig: redactedNextConfig,
+            changedKeys,
+            nextActions: [
+                "Review the config preview.",
+                "Call this tool again with dryRun=false to write.",
+            ],
+        };
+    }
+    await mkdir(dirname(readResult.configPath), { recursive: true });
+    let backupPath = null;
+    if (readResult.exists) {
+        backupPath = `${readResult.configPath}.bak-${new Date().toISOString().replace(/[:.]/g, "-")}`;
+        await writeFile(backupPath, stableJson(readResult.config), { mode: 0o600 });
+    }
+    const tempPath = `${readResult.configPath}.tmp-${process.pid}`;
+    await writeFile(tempPath, stableJson(nextConfig), { mode: 0o600 });
+    await rename(tempPath, readResult.configPath);
+    const handle = await open(readResult.configPath, "r+");
+    await handle.chmod(0o600);
+    await handle.close();
+    return {
+        configPath: readResult.configPath,
+        dryRun,
+        written: true,
+        backupPath,
+        previousConfig,
+        nextConfig: redactedNextConfig,
+        changedKeys,
+        nextActions: [
+            "Restart or reload the MCP client if it keeps a long-running server process.",
+            "Call granoflow_setup_status to verify the resolved configuration.",
+        ],
+    };
+}
+export async function configFileExists(configPath) {
+    try {
+        await stat(configPath);
+        return true;
+    }
+    catch (error) {
+        if (isObject(error) && "code" in error && error.code === "ENOENT") {
+            return false;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAyC1C,MAAM,kBAAkB,GAAG,yCAAyC,CAAC;AACrE,MAAM,oBAAoB,GAAG,wBAAwB,CAAC;AAEtD,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,kBAAkB,CAAC,UAAkB;IAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAChC,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACnE,IAAI,GAAG,CAAC,yBAAyB,EAAE,CAAC;QAClC,OAAO,GAAG,CAAC,yBAAyB,CAAC;IACvC,CAAC;IACD,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAA0B;IACrD,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,QAAQ,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7F,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,OAAO;gBACL,UAAU;gBACV,MAAM,EAAE,IAAI;gBACZ,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,yCAAyC;aACjD,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACnD,CAAC;QACD,OAAO;YACL,UAAU;YACV,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,EAAE;YACV,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,YAAY,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;IACnC,MAAM,UAAU,GACd,GAAG,CAAC,sBAAsB;QAC1B,CAAC,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QACvE,oBAAoB,CAAC;IAEvB,OAAO;QACL,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,YAAY,EAAE,YAAY,CAAC,MAAM;QACjC,WAAW,EAAE,YAAY,CAAC,KAAK;QAC/B,UAAU;QACV,gBAAgB,EAAE,GAAG,CAAC,sBAAsB;YAC1C,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;gBACrC,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAC,SAAS;QACf,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QAC7C,cAAc,EAAE,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM;QACxD,QAAQ,EAAE,GAAG,CAAC,mBAAmB;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAuB,EACvB,MAAyB,OAAO,CAAC,GAAG;IAEpC,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACnC,kBAAkB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAuB,EAAE,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;IAChE,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACnC,UAAU,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IAC3C,CAAC;IAED,MAAM,cAAc,GAAG,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,kBAAkB,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IACpD,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,MAAM,CACxD,CAAC,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,kBAAkB,CAAC,GAAG,CAAC,CACzD,CAAC;IACF,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC;IAEtC,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;YACL,UAAU,EAAE,UAAU,CAAC,UAAU;YACjC,MAAM;YACN,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,IAAI;YAChB,cAAc;YACd,UAAU,EAAE,kBAAkB;YAC9B,WAAW;YACX,WAAW,EAAE;gBACX,4BAA4B;gBAC5B,kDAAkD;aACnD;SACF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;QACtB,UAAU,GAAG,GAAG,UAAU,CAAC,UAAU,QAAQ,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC;QAC9F,MAAM,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,QAAQ,GAAG,GAAG,UAAU,CAAC,UAAU,QAAQ,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/D,MAAM,SAAS,CAAC,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACnE,MAAM,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACvD,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IAErB,OAAO;QACL,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,MAAM;QACN,OAAO,EAAE,IAAI;QACb,UAAU;QACV,cAAc;QACd,UAAU,EAAE,kBAAkB;QAC9B,WAAW;QACX,WAAW,EAAE;YACX,6EAA6E;YAC7E,mEAAmE;SACpE;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,UAAkB;IACvD,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { SERVER_NAME, SERVER_VERSION } from "./metadata.js";
+import { registerGranoflowTools } from "./tools.js";
+function printHelp() {
+    process.stdout.write(`${SERVER_NAME} ${SERVER_VERSION}
+
+Usage:
+  granoflow-mcp-server
+  granoflow-mcp-server --help
+  granoflow-mcp-server --version
+
+Starts the Granoflow MCP server over stdio.
+
+Environment:
+  GRANOFLOW_API_BASE_URL    Optional Granoflow Local HTTP API base URL.
+  GRANOFLOW_API_TOKEN       Optional Granoflow Local HTTP API token.
+  GRANOFLOW_MCP_CONFIG_PATH Optional path for MCP-owned non-secret config.
+`);
+}
+if (process.argv.includes("--version") || process.argv.includes("-v")) {
+    process.stdout.write(`${SERVER_VERSION}\n`);
+    process.exit(0);
+}
+if (process.argv.includes("--help") || process.argv.includes("-h")) {
+    printHelp();
+    process.exit(0);
+}
+const server = new McpServer({
+    name: SERVER_NAME,
+    version: SERVER_VERSION,
+});
+registerGranoflowTools(server);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD,SAAS,SAAS;IAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,IAAI,cAAc;;;;;;;;;;;;;CAatD,CAAC,CAAC;AACH,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACtE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,cAAc,IAAI,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACnE,SAAS,EAAE,CAAC;IACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,cAAc;CACxB,CAAC,CAAC;AAEH,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAE/B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/metadata.d.ts

@@ -0,0 +1,2 @@
+export declare const SERVER_NAME = "granoflow-mcp-server";
+export declare const SERVER_VERSION = "0.1.0";

package/dist/metadata.js

@@ -0,0 +1,3 @@
+export const SERVER_NAME = "granoflow-mcp-server";
+export const SERVER_VERSION = "0.1.0";
+//# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,sBAAsB,CAAC;AAClD,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC"}