@lonca/baron-mcp-server 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,139 @@
+import { IssuesPort, ScmPort, CiPort, NotifyPort, DeployPort } from '@lonca/baron-core';
+import { KnowledgeLoop } from '@lonca/baron-knowledge-loop';
+import { NativeRequest, NativeResponse, Env } from '@lonca/baron-providers';
+import { RecipeService } from '@lonca/baron-recipes';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+
+/** The provider-native escape hatch (decision #18), restricted by the caller to bound providers. */
+type NativeAccess = (provider: string, request: NativeRequest) => Promise<NativeResponse>;
+/** The ports the MCP server serves. issues/scm bind from policy; knowledge is always available. */
+interface McpPorts {
+    readonly issues?: IssuesPort;
+    readonly scm?: ScmPort;
+    readonly ci?: CiPort;
+    readonly notify?: NotifyPort;
+    readonly deploy?: DeployPort;
+    readonly knowledge?: KnowledgeLoop;
+    /** Provider-native escape hatch (decision #18); set by the loader, scoped to bound providers. */
+    readonly nativeAccess?: NativeAccess;
+    /** Deterministic recipe runner (built-ins + project recipes) over the bound ports. */
+    readonly recipes?: RecipeService;
+}
+/** Tool names: snake_case, `baron_` (product) namespace, singular noun to mirror the primitives. */
+declare const MCP_TOOL_NAMES: {
+    readonly create: "baron_issue_create";
+    readonly get: "baron_issue_get";
+    readonly transition: "baron_issue_transition";
+    readonly comment: "baron_issue_comment";
+    readonly link: "baron_issue_link";
+    readonly query: "baron_issue_query";
+};
+declare const SCM_TOOL_NAMES: {
+    readonly branchCreate: "baron_scm_branch_create";
+    readonly prCreate: "baron_scm_pr_create";
+    readonly prThread: "baron_scm_pr_thread";
+    readonly prStatus: "baron_scm_pr_status";
+};
+declare const CI_TOOL_NAMES: {
+    readonly pipelines: "baron_ci_pipelines";
+    readonly runs: "baron_ci_runs";
+    readonly runGet: "baron_ci_run_get";
+    readonly runLogs: "baron_ci_run_logs";
+    readonly runTrigger: "baron_ci_run_trigger";
+    readonly runCancel: "baron_ci_run_cancel";
+};
+declare const NOTIFY_TOOL_NAMES: {
+    readonly send: "baron_notify_send";
+};
+declare const DEPLOY_TOOL_NAMES: {
+    readonly environments: "baron_deploy_environments";
+    readonly deployments: "baron_deploy_deployments";
+};
+declare const NATIVE_TOOL_NAMES: {
+    readonly request: "baron_native_request";
+};
+declare const RECIPE_TOOL_NAMES: {
+    readonly list: "baron_recipe_list";
+    readonly run: "baron_recipe_run";
+};
+declare const LOOP_TOOL_NAMES: {
+    readonly learningAppend: "baron_learning_append";
+    readonly learningQuery: "baron_learning_query";
+    readonly followupAppend: "baron_followup_append";
+    readonly followupList: "baron_followup_list";
+};
+/** A tool definition shaped for the MCP ListTools response (plain JSON Schema, no zod). */
+interface ToolDefinition {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: 'object';
+        readonly properties: Record<string, unknown>;
+        readonly required?: readonly string[];
+        readonly additionalProperties: false;
+    };
+}
+/** The MCP text result shape (structurally a CallToolResult); kept SDK-agnostic for testability. */
+interface ToolResult {
+    readonly content: ReadonlyArray<{
+        readonly type: 'text';
+        readonly text: string;
+    }>;
+    readonly isError?: boolean;
+    readonly structuredContent?: Record<string, unknown>;
+}
+declare const TOOL_DEFINITIONS: readonly ToolDefinition[];
+declare const SCM_TOOL_DEFINITIONS: readonly ToolDefinition[];
+declare const CI_TOOL_DEFINITIONS: readonly ToolDefinition[];
+declare const NOTIFY_TOOL_DEFINITIONS: readonly ToolDefinition[];
+declare const DEPLOY_TOOL_DEFINITIONS: readonly ToolDefinition[];
+declare const NATIVE_TOOL_DEFINITIONS: readonly ToolDefinition[];
+declare const RECIPE_TOOL_DEFINITIONS: readonly ToolDefinition[];
+declare const LOOP_TOOL_DEFINITIONS: readonly ToolDefinition[];
+/**
+ * Dispatch an MCP tool call to the issues port. Marshals arguments and shapes errors only — it does
+ * no role/state translation (invariant #4) and holds no workflow opinion (invariant #3). Unknown
+ * tool names and bad arguments surface as isError results so the agent always sees them.
+ */
+declare function callTool(port: IssuesPort, name: string, args: Record<string, unknown> | undefined): Promise<ToolResult>;
+/** Dispatch an scm tool call to the scm port (marshalling + error shaping only). */
+declare function callScmTool(port: ScmPort, name: string, args: Record<string, unknown> | undefined): Promise<ToolResult>;
+/** Dispatch a knowledge-loop tool call (marshalling + error shaping only). */
+declare function callLoopTool(loop: KnowledgeLoop, name: string, args: Record<string, unknown> | undefined): Promise<ToolResult>;
+/** Dispatch an MCP tool call to the ci port. Marshals + shapes errors only. */
+declare function callCiTool(port: CiPort, name: string, args: Record<string, unknown> | undefined): Promise<ToolResult>;
+/** Dispatch an MCP tool call to the notify port. Marshals + shapes errors only. */
+declare function callNotifyTool(port: NotifyPort, name: string, args: Record<string, unknown> | undefined): Promise<ToolResult>;
+/** Dispatch an MCP tool call to the deploy port. Marshals + shapes errors only. */
+declare function callDeployTool(port: DeployPort, name: string, args: Record<string, unknown> | undefined): Promise<ToolResult>;
+/** Dispatch an MCP tool call to the recipe runner. Marshals + shapes errors only. */
+declare function callRecipeTool(service: RecipeService, name: string, args: Record<string, unknown> | undefined): Promise<ToolResult>;
+/** Dispatch the escape-hatch tool to the native access fn. Marshals + shapes errors only. */
+declare function callNativeTool(access: NativeAccess, name: string, args: Record<string, unknown> | undefined): Promise<ToolResult>;
+/** The tool definitions advertised for the currently-bound ports. */
+declare function activeToolDefinitions(ports: McpPorts): ToolDefinition[];
+/** Route a tool call to the right port by its name prefix; unbound ports / unknown names error. */
+declare function dispatchTool(ports: McpPorts, name: string, args: Record<string, unknown> | undefined): Promise<ToolResult>;
+
+declare const SERVER_INFO: {
+    readonly name: "baron";
+    readonly version: "0.0.0";
+};
+/**
+ * Wire the bound ports' primitives onto a low-level MCP {@link Server}. It advertises only the tools
+ * for ports present in {@link McpPorts} and routes each call to the right port by name prefix. The
+ * handlers only marshal — all translation lives in the ports (invariant #4). The pure tool-definition
+ * / result shapes are structurally the SDK's, cast at this single boundary to bridge readonly /
+ * zod-inferred nominal differences while keeping `tools.ts` SDK-free.
+ */
+declare function createMcpServer(ports: McpPorts): Server;
+
+/**
+ * Load the committed policy and build the ports it serves: the issues/scm ports it binds (either or
+ * both) plus the always-available local knowledge loop (markdown store under `.baron/knowledge`). A
+ * missing policy is a server-lifecycle failure (POLICY_NOT_FOUND). Credentials come from `env`
+ * (overlaid by a gitignored `.baron/credentials` file when present), never from the policy.
+ */
+declare function loadPorts(root: string, env: Env): McpPorts;
+
+export { CI_TOOL_DEFINITIONS, CI_TOOL_NAMES, DEPLOY_TOOL_DEFINITIONS, DEPLOY_TOOL_NAMES, LOOP_TOOL_DEFINITIONS, LOOP_TOOL_NAMES, MCP_TOOL_NAMES, type McpPorts, NATIVE_TOOL_DEFINITIONS, NATIVE_TOOL_NAMES, NOTIFY_TOOL_DEFINITIONS, NOTIFY_TOOL_NAMES, type NativeAccess, RECIPE_TOOL_DEFINITIONS, RECIPE_TOOL_NAMES, SCM_TOOL_DEFINITIONS, SCM_TOOL_NAMES, SERVER_INFO, TOOL_DEFINITIONS, type ToolDefinition, type ToolResult, activeToolDefinitions, callCiTool, callDeployTool, callLoopTool, callNativeTool, callNotifyTool, callRecipeTool, callScmTool, callTool, createMcpServer, dispatchTool, loadPorts };

package/dist/index.js

@@ -0,0 +1,62 @@
+import {
+  CI_TOOL_DEFINITIONS,
+  CI_TOOL_NAMES,
+  DEPLOY_TOOL_DEFINITIONS,
+  DEPLOY_TOOL_NAMES,
+  LOOP_TOOL_DEFINITIONS,
+  LOOP_TOOL_NAMES,
+  MCP_TOOL_NAMES,
+  NATIVE_TOOL_DEFINITIONS,
+  NATIVE_TOOL_NAMES,
+  NOTIFY_TOOL_DEFINITIONS,
+  NOTIFY_TOOL_NAMES,
+  RECIPE_TOOL_DEFINITIONS,
+  RECIPE_TOOL_NAMES,
+  SCM_TOOL_DEFINITIONS,
+  SCM_TOOL_NAMES,
+  SERVER_INFO,
+  TOOL_DEFINITIONS,
+  activeToolDefinitions,
+  callCiTool,
+  callDeployTool,
+  callLoopTool,
+  callNativeTool,
+  callNotifyTool,
+  callRecipeTool,
+  callScmTool,
+  callTool,
+  createMcpServer,
+  dispatchTool,
+  loadPorts
+} from "./chunk-MUGSC3EW.js";
+export {
+  CI_TOOL_DEFINITIONS,
+  CI_TOOL_NAMES,
+  DEPLOY_TOOL_DEFINITIONS,
+  DEPLOY_TOOL_NAMES,
+  LOOP_TOOL_DEFINITIONS,
+  LOOP_TOOL_NAMES,
+  MCP_TOOL_NAMES,
+  NATIVE_TOOL_DEFINITIONS,
+  NATIVE_TOOL_NAMES,
+  NOTIFY_TOOL_DEFINITIONS,
+  NOTIFY_TOOL_NAMES,
+  RECIPE_TOOL_DEFINITIONS,
+  RECIPE_TOOL_NAMES,
+  SCM_TOOL_DEFINITIONS,
+  SCM_TOOL_NAMES,
+  SERVER_INFO,
+  TOOL_DEFINITIONS,
+  activeToolDefinitions,
+  callCiTool,
+  callDeployTool,
+  callLoopTool,
+  callNativeTool,
+  callNotifyTool,
+  callRecipeTool,
+  callScmTool,
+  callTool,
+  createMcpServer,
+  dispatchTool,
+  loadPorts
+};

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@lonca/baron-mcp-server",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "Apache-2.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "baron-mcp": "./dist/bin.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@lonca/baron-core": "0.1.0",
+    "@lonca/baron-providers": "0.1.0",
+    "@lonca/baron-knowledge-loop": "0.1.0",
+    "@lonca/baron-recipes": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@lonca/baron-conformance": "0.1.0",
+    "@lonca/baron-adapter-github": "0.1.0"
+  },
+  "description": "Baron MCP server: drive issues, scm, ci, deploy, and notify across providers from any MCP client.",
+  "keywords": [
+    "baron",
+    "ai-agents",
+    "mcp",
+    "work-orchestration",
+    "devops",
+    "model-context-protocol",
+    "claude",
+    "server"
+  ],
+  "author": "Baron contributors",
+  "homepage": "https://github.com/loncadev/baron#readme",
+  "bugs": {
+    "url": "https://github.com/loncadev/baron/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/loncadev/baron.git",
+    "directory": "packages/mcp-server"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts src/bin.ts --format esm --dts --clean",
+    "typecheck": "tsc --noEmit"
+  }
+}