@apart-tech/intelligence-mcp 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,349 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { loadConfig, getTenantDb, NodeService, EdgeService, SearchService, ContextService, DomainService, WorkspaceService, createEmbeddingProvider, SINGLE_TENANT_ORG_ID, } from "@apart-tech/intelligence-core";
+const config = loadConfig();
+const tenant = {
+    organizationId: config.tenancy.organizationId ?? SINGLE_TENANT_ORG_ID,
+};
+const db = getTenantDb(config.database.url, tenant);
+const embeddings = createEmbeddingProvider(config, { db });
+const nodeService = new NodeService(db, embeddings, tenant);
+const edgeService = new EdgeService(db);
+const searchService = new SearchService(db, embeddings, config, tenant);
+const domainService = new DomainService(db, tenant);
+const workspaceService = new WorkspaceService(db, tenant);
+const contextService = new ContextService(nodeService, edgeService, searchService, config, workspaceService, domainService);
+const server = new McpServer({
+    name: "apart-intelligence",
+    version: "0.1.0",
+});
+// ── Read Tools ─────────────────────────────────────────────────────────────
+server.tool("search_knowledge", "Hybrid semantic + keyword search across all knowledge nodes", {
+    query: z.string().describe("Search query"),
+    limit: z.number().optional().describe("Max results (default 10)"),
+    types: z
+        .array(z.string())
+        .optional()
+        .describe("Filter by node types"),
+    include_drafts: z
+        .boolean()
+        .optional()
+        .describe("Include draft nodes in results"),
+    domain_slugs: z
+        .array(z.string())
+        .optional()
+        .describe("Filter by domain slugs"),
+    workspace: z
+        .string()
+        .optional()
+        .describe("Workspace slug — auto-applies domain/type/tag filters"),
+}, async ({ query, limit, types, include_drafts, domain_slugs, workspace }) => {
+    let domainIds;
+    let resolvedTypes = types;
+    // Apply workspace filters (explicit params override workspace defaults)
+    if (workspace) {
+        const filter = await workspaceService.resolveFilter(workspace, (slugs) => domainService.resolveSlugs(slugs));
+        if (filter) {
+            if (!domainIds && filter.domainIds)
+                domainIds = filter.domainIds;
+            if (!resolvedTypes && filter.types)
+                resolvedTypes = filter.types;
+        }
+    }
+    if (domain_slugs?.length) {
+        domainIds = await domainService.resolveSlugs(domain_slugs);
+    }
+    const results = await searchService.search({
+        query,
+        limit,
+        types: resolvedTypes,
+        includeDrafts: include_drafts,
+        domainIds,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(results, null, 2),
+            },
+        ],
+    };
+});
+server.tool("get_node", "Retrieve a specific knowledge node by ID with its edges", {
+    id: z.string().describe("Node UUID"),
+}, async ({ id }) => {
+    const node = await nodeService.getById(id);
+    if (!node) {
+        return {
+            content: [{ type: "text", text: "Node not found" }],
+            isError: true,
+        };
+    }
+    const edges = await edgeService.getByNodeId(id);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({ node, edges }, null, 2),
+            },
+        ],
+    };
+});
+server.tool("get_context", "Assemble a context package for a topic — returns related nodes with their relationships", {
+    query: z.string().describe("Topic or question for context assembly"),
+    max_depth: z.number().optional().describe("Graph traversal depth (default 1)"),
+    max_nodes: z.number().optional().describe("Max nodes to return (default 20)"),
+    include_drafts: z.boolean().optional().describe("Include draft nodes"),
+    types: z.array(z.string()).optional().describe("Filter by node types"),
+    domain_slugs: z
+        .array(z.string())
+        .optional()
+        .describe("Filter by domain slugs"),
+    workspace: z
+        .string()
+        .optional()
+        .describe("Workspace slug — auto-applies all workspace filters"),
+}, async ({ query, max_depth, max_nodes, include_drafts, types, domain_slugs, workspace }) => {
+    let domainIds;
+    if (domain_slugs?.length) {
+        domainIds = await domainService.resolveSlugs(domain_slugs);
+    }
+    const ctx = await contextService.assemble({
+        query,
+        maxDepth: max_depth,
+        maxNodes: max_nodes,
+        includeDrafts: include_drafts,
+        types,
+        domainIds,
+        workspace,
+    });
+    return {
+        content: [
+            { type: "text", text: JSON.stringify(ctx, null, 2) },
+        ],
+    };
+});
+server.tool("get_neighborhood", "Return a node and its N-hop graph neighborhood", {
+    id: z.string().describe("Node UUID"),
+    depth: z.number().optional().describe("Hops to traverse (default 1)"),
+}, async ({ id, depth }) => {
+    const node = await nodeService.getById(id);
+    if (!node) {
+        return {
+            content: [{ type: "text", text: "Node not found" }],
+            isError: true,
+        };
+    }
+    const neighborIds = await edgeService.getNeighborIds(id, depth ?? 1);
+    const neighbors = [];
+    for (const nId of neighborIds) {
+        const n = await nodeService.getById(nId);
+        if (n)
+            neighbors.push(n);
+    }
+    const edges = await edgeService.getByNodeId(id);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({ node, neighbors, edges }, null, 2),
+            },
+        ],
+    };
+});
+server.tool("list_drafts", "List all draft nodes pending curation", {
+    limit: z.number().optional().describe("Max results (default 50)"),
+}, async ({ limit }) => {
+    const drafts = await nodeService.listDrafts(limit);
+    return {
+        content: [
+            { type: "text", text: JSON.stringify(drafts, null, 2) },
+        ],
+    };
+});
+server.tool("list_types", "List all node types and relationship types currently in use", {}, async () => {
+    const [nodeTypes, edgeTypes] = await Promise.all([
+        nodeService.listTypes(),
+        edgeService.listRelationshipTypes(),
+    ]);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({ nodeTypes, edgeTypes }, null, 2),
+            },
+        ],
+    };
+});
+server.tool("list_domains", "List the full domain taxonomy tree", {}, async () => {
+    const tree = await domainService.getTree();
+    return {
+        content: [
+            { type: "text", text: JSON.stringify(tree, null, 2) },
+        ],
+    };
+});
+server.tool("seed_domains", "Seed the default domain taxonomy", {}, async () => {
+    const result = await domainService.seed();
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+});
+// ── Workspace Tools ───────────────────────────────────────────────────────
+server.tool("list_workspaces", "List all workspaces — each defines a filtered view of the knowledge graph for a specific kind of work", {}, async () => {
+    const list = await workspaceService.list();
+    return {
+        content: [
+            { type: "text", text: JSON.stringify(list, null, 2) },
+        ],
+    };
+});
+server.tool("get_workspace", "Get full workspace definition including filter rules and system prompt", {
+    slug: z.string().describe("Workspace slug"),
+}, async ({ slug }) => {
+    const ws = await workspaceService.getBySlug(slug);
+    if (!ws) {
+        return {
+            content: [{ type: "text", text: "Workspace not found" }],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            { type: "text", text: JSON.stringify(ws, null, 2) },
+        ],
+    };
+});
+server.tool("export_workspace", "Export a workspace as a CLAUDE.md-formatted markdown document", {
+    slug: z.string().describe("Workspace slug"),
+}, async ({ slug }) => {
+    const md = await workspaceService.exportAsMarkdown(slug);
+    if (!md) {
+        return {
+            content: [{ type: "text", text: "Workspace not found" }],
+            isError: true,
+        };
+    }
+    return {
+        content: [{ type: "text", text: md }],
+    };
+});
+// ── Write Tools ────────────────────────────────────────────────────────────
+server.tool("add_node", "Create a new knowledge node (defaults to draft status)", {
+    type: z
+        .string()
+        .describe("Node type (policy, process, decision, customer, etc.)"),
+    title: z.string().describe("Human-readable title"),
+    content: z.string().describe("Markdown content body"),
+    metadata: z
+        .record(z.unknown())
+        .optional()
+        .describe("Optional key-value metadata"),
+    created_by: z
+        .string()
+        .optional()
+        .describe("Creator identifier (default: mcp)"),
+    domain_slug: z
+        .string()
+        .optional()
+        .describe("Domain slug to assign to the node"),
+}, async ({ type, title, content, metadata, created_by, domain_slug }) => {
+    let domainId;
+    if (domain_slug) {
+        const domain = await domainService.getBySlug(domain_slug);
+        if (domain)
+            domainId = domain.id;
+    }
+    const node = await nodeService.create({
+        type,
+        title,
+        content,
+        metadata,
+        createdBy: created_by ?? "mcp",
+        domainId,
+    });
+    return {
+        content: [
+            { type: "text", text: JSON.stringify(node, null, 2) },
+        ],
+    };
+});
+server.tool("update_node", "Update content or metadata of an existing knowledge node", {
+    id: z.string().describe("Node UUID"),
+    title: z.string().optional().describe("New title"),
+    content: z.string().optional().describe("New markdown content"),
+    metadata: z.record(z.unknown()).optional().describe("New metadata"),
+    type: z.string().optional().describe("New node type"),
+}, async ({ id, title, content, metadata, type }) => {
+    const node = await nodeService.update(id, { title, content, metadata, type });
+    if (!node) {
+        return {
+            content: [{ type: "text", text: "Node not found" }],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            { type: "text", text: JSON.stringify(node, null, 2) },
+        ],
+    };
+});
+server.tool("link_nodes", "Create an edge between two knowledge nodes", {
+    source_node_id: z.string().describe("Source node UUID"),
+    target_node_id: z.string().describe("Target node UUID"),
+    relationship_type: z
+        .string()
+        .describe("Edge type (relates-to, part-of, supersedes, etc.)"),
+    weight: z.number().optional().describe("Relevance weight (default 1.0)"),
+    created_by: z.string().optional().describe("Creator identifier"),
+}, async ({ source_node_id, target_node_id, relationship_type, weight, created_by }) => {
+    const edge = await edgeService.create({
+        sourceNodeId: source_node_id,
+        targetNodeId: target_node_id,
+        relationshipType: relationship_type,
+        weight,
+        createdBy: created_by ?? "mcp",
+    });
+    return {
+        content: [
+            { type: "text", text: JSON.stringify(edge, null, 2) },
+        ],
+    };
+});
+server.tool("set_status", "Change node status (draft/reviewed/approved/archived)", {
+    id: z.string().describe("Node UUID"),
+    status: z
+        .enum(["draft", "reviewed", "approved", "archived"])
+        .describe("New status"),
+}, async ({ id, status }) => {
+    const node = await nodeService.setStatus(id, status);
+    if (!node) {
+        return {
+            content: [{ type: "text", text: "Node not found" }],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            { type: "text", text: JSON.stringify(node, null, 2) },
+        ],
+    };
+});
+// ── Start Server ───────────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Apart Intelligence MCP server running on stdio");
+}
+main().catch((err) => {
+    console.error("Failed to start MCP server:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@apart-tech/intelligence-mcp",
+  "version": "0.2.0",
+  "description": "MCP server for Apart Intelligence knowledge graph",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "tc-mcp": "dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.8.0",
+    "zod": "^3.24.0",
+    "@apart-tech/intelligence-core": "1.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "lint": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}

package/src/index.ts

@@ -0,0 +1,466 @@
+#!/usr/bin/env node
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import {
+  loadConfig,
+  getTenantDb,
+  NodeService,
+  EdgeService,
+  SearchService,
+  ContextService,
+  DomainService,
+  WorkspaceService,
+  createEmbeddingProvider,
+  SINGLE_TENANT_ORG_ID,
+} from "@apart-tech/intelligence-core";
+import type { NodeStatus, TenantContext } from "@apart-tech/intelligence-core";
+
+const config = loadConfig();
+const tenant: TenantContext = {
+  organizationId: config.tenancy.organizationId ?? SINGLE_TENANT_ORG_ID,
+};
+const db = getTenantDb(config.database.url, tenant);
+const embeddings = createEmbeddingProvider(config, { db });
+const nodeService = new NodeService(db, embeddings, tenant);
+const edgeService = new EdgeService(db);
+const searchService = new SearchService(db, embeddings, config, tenant);
+const domainService = new DomainService(db, tenant);
+const workspaceService = new WorkspaceService(db, tenant);
+const contextService = new ContextService(
+  nodeService,
+  edgeService,
+  searchService,
+  config,
+  workspaceService,
+  domainService,
+);
+
+const server = new McpServer({
+  name: "apart-intelligence",
+  version: "0.1.0",
+});
+
+// ── Read Tools ─────────────────────────────────────────────────────────────
+
+server.tool(
+  "search_knowledge",
+  "Hybrid semantic + keyword search across all knowledge nodes",
+  {
+    query: z.string().describe("Search query"),
+    limit: z.number().optional().describe("Max results (default 10)"),
+    types: z
+      .array(z.string())
+      .optional()
+      .describe("Filter by node types"),
+    include_drafts: z
+      .boolean()
+      .optional()
+      .describe("Include draft nodes in results"),
+    domain_slugs: z
+      .array(z.string())
+      .optional()
+      .describe("Filter by domain slugs"),
+    workspace: z
+      .string()
+      .optional()
+      .describe("Workspace slug — auto-applies domain/type/tag filters"),
+  },
+  async ({ query, limit, types, include_drafts, domain_slugs, workspace }) => {
+    let domainIds: string[] | undefined;
+    let resolvedTypes = types;
+
+    // Apply workspace filters (explicit params override workspace defaults)
+    if (workspace) {
+      const filter = await workspaceService.resolveFilter(workspace, (slugs) =>
+        domainService.resolveSlugs(slugs),
+      );
+      if (filter) {
+        if (!domainIds && filter.domainIds) domainIds = filter.domainIds;
+        if (!resolvedTypes && filter.types) resolvedTypes = filter.types;
+      }
+    }
+
+    if (domain_slugs?.length) {
+      domainIds = await domainService.resolveSlugs(domain_slugs);
+    }
+    const results = await searchService.search({
+      query,
+      limit,
+      types: resolvedTypes,
+      includeDrafts: include_drafts,
+      domainIds,
+    });
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: JSON.stringify(results, null, 2),
+        },
+      ],
+    };
+  }
+);
+
+server.tool(
+  "get_node",
+  "Retrieve a specific knowledge node by ID with its edges",
+  {
+    id: z.string().describe("Node UUID"),
+  },
+  async ({ id }) => {
+    const node = await nodeService.getById(id);
+    if (!node) {
+      return {
+        content: [{ type: "text" as const, text: "Node not found" }],
+        isError: true,
+      };
+    }
+    const edges = await edgeService.getByNodeId(id);
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: JSON.stringify({ node, edges }, null, 2),
+        },
+      ],
+    };
+  }
+);
+
+server.tool(
+  "get_context",
+  "Assemble a context package for a topic — returns related nodes with their relationships",
+  {
+    query: z.string().describe("Topic or question for context assembly"),
+    max_depth: z.number().optional().describe("Graph traversal depth (default 1)"),
+    max_nodes: z.number().optional().describe("Max nodes to return (default 20)"),
+    include_drafts: z.boolean().optional().describe("Include draft nodes"),
+    types: z.array(z.string()).optional().describe("Filter by node types"),
+    domain_slugs: z
+      .array(z.string())
+      .optional()
+      .describe("Filter by domain slugs"),
+    workspace: z
+      .string()
+      .optional()
+      .describe("Workspace slug — auto-applies all workspace filters"),
+  },
+  async ({ query, max_depth, max_nodes, include_drafts, types, domain_slugs, workspace }) => {
+    let domainIds: string[] | undefined;
+    if (domain_slugs?.length) {
+      domainIds = await domainService.resolveSlugs(domain_slugs);
+    }
+    const ctx = await contextService.assemble({
+      query,
+      maxDepth: max_depth,
+      maxNodes: max_nodes,
+      includeDrafts: include_drafts,
+      types,
+      domainIds,
+      workspace,
+    });
+    return {
+      content: [
+        { type: "text" as const, text: JSON.stringify(ctx, null, 2) },
+      ],
+    };
+  }
+);
+
+server.tool(
+  "get_neighborhood",
+  "Return a node and its N-hop graph neighborhood",
+  {
+    id: z.string().describe("Node UUID"),
+    depth: z.number().optional().describe("Hops to traverse (default 1)"),
+  },
+  async ({ id, depth }) => {
+    const node = await nodeService.getById(id);
+    if (!node) {
+      return {
+        content: [{ type: "text" as const, text: "Node not found" }],
+        isError: true,
+      };
+    }
+    const neighborIds = await edgeService.getNeighborIds(id, depth ?? 1);
+    const neighbors = [];
+    for (const nId of neighborIds) {
+      const n = await nodeService.getById(nId);
+      if (n) neighbors.push(n);
+    }
+    const edges = await edgeService.getByNodeId(id);
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: JSON.stringify({ node, neighbors, edges }, null, 2),
+        },
+      ],
+    };
+  }
+);
+
+server.tool(
+  "list_drafts",
+  "List all draft nodes pending curation",
+  {
+    limit: z.number().optional().describe("Max results (default 50)"),
+  },
+  async ({ limit }) => {
+    const drafts = await nodeService.listDrafts(limit);
+    return {
+      content: [
+        { type: "text" as const, text: JSON.stringify(drafts, null, 2) },
+      ],
+    };
+  }
+);
+
+server.tool(
+  "list_types",
+  "List all node types and relationship types currently in use",
+  {},
+  async () => {
+    const [nodeTypes, edgeTypes] = await Promise.all([
+      nodeService.listTypes(),
+      edgeService.listRelationshipTypes(),
+    ]);
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: JSON.stringify({ nodeTypes, edgeTypes }, null, 2),
+        },
+      ],
+    };
+  }
+);
+
+server.tool(
+  "list_domains",
+  "List the full domain taxonomy tree",
+  {},
+  async () => {
+    const tree = await domainService.getTree();
+    return {
+      content: [
+        { type: "text" as const, text: JSON.stringify(tree, null, 2) },
+      ],
+    };
+  }
+);
+
+server.tool(
+  "seed_domains",
+  "Seed the default domain taxonomy",
+  {},
+  async () => {
+    const result = await domainService.seed();
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: JSON.stringify(result, null, 2),
+        },
+      ],
+    };
+  }
+);
+
+// ── Workspace Tools ───────────────────────────────────────────────────────
+
+server.tool(
+  "list_workspaces",
+  "List all workspaces — each defines a filtered view of the knowledge graph for a specific kind of work",
+  {},
+  async () => {
+    const list = await workspaceService.list();
+    return {
+      content: [
+        { type: "text" as const, text: JSON.stringify(list, null, 2) },
+      ],
+    };
+  }
+);
+
+server.tool(
+  "get_workspace",
+  "Get full workspace definition including filter rules and system prompt",
+  {
+    slug: z.string().describe("Workspace slug"),
+  },
+  async ({ slug }) => {
+    const ws = await workspaceService.getBySlug(slug);
+    if (!ws) {
+      return {
+        content: [{ type: "text" as const, text: "Workspace not found" }],
+        isError: true,
+      };
+    }
+    return {
+      content: [
+        { type: "text" as const, text: JSON.stringify(ws, null, 2) },
+      ],
+    };
+  }
+);
+
+server.tool(
+  "export_workspace",
+  "Export a workspace as a CLAUDE.md-formatted markdown document",
+  {
+    slug: z.string().describe("Workspace slug"),
+  },
+  async ({ slug }) => {
+    const md = await workspaceService.exportAsMarkdown(slug);
+    if (!md) {
+      return {
+        content: [{ type: "text" as const, text: "Workspace not found" }],
+        isError: true,
+      };
+    }
+    return {
+      content: [{ type: "text" as const, text: md }],
+    };
+  }
+);
+
+// ── Write Tools ────────────────────────────────────────────────────────────
+
+server.tool(
+  "add_node",
+  "Create a new knowledge node (defaults to draft status)",
+  {
+    type: z
+      .string()
+      .describe("Node type (policy, process, decision, customer, etc.)"),
+    title: z.string().describe("Human-readable title"),
+    content: z.string().describe("Markdown content body"),
+    metadata: z
+      .record(z.unknown())
+      .optional()
+      .describe("Optional key-value metadata"),
+    created_by: z
+      .string()
+      .optional()
+      .describe("Creator identifier (default: mcp)"),
+    domain_slug: z
+      .string()
+      .optional()
+      .describe("Domain slug to assign to the node"),
+  },
+  async ({ type, title, content, metadata, created_by, domain_slug }) => {
+    let domainId: string | undefined;
+    if (domain_slug) {
+      const domain = await domainService.getBySlug(domain_slug);
+      if (domain) domainId = domain.id;
+    }
+    const node = await nodeService.create({
+      type,
+      title,
+      content,
+      metadata,
+      createdBy: created_by ?? "mcp",
+      domainId,
+    });
+    return {
+      content: [
+        { type: "text" as const, text: JSON.stringify(node, null, 2) },
+      ],
+    };
+  }
+);
+
+server.tool(
+  "update_node",
+  "Update content or metadata of an existing knowledge node",
+  {
+    id: z.string().describe("Node UUID"),
+    title: z.string().optional().describe("New title"),
+    content: z.string().optional().describe("New markdown content"),
+    metadata: z.record(z.unknown()).optional().describe("New metadata"),
+    type: z.string().optional().describe("New node type"),
+  },
+  async ({ id, title, content, metadata, type }) => {
+    const node = await nodeService.update(id, { title, content, metadata, type });
+    if (!node) {
+      return {
+        content: [{ type: "text" as const, text: "Node not found" }],
+        isError: true,
+      };
+    }
+    return {
+      content: [
+        { type: "text" as const, text: JSON.stringify(node, null, 2) },
+      ],
+    };
+  }
+);
+
+server.tool(
+  "link_nodes",
+  "Create an edge between two knowledge nodes",
+  {
+    source_node_id: z.string().describe("Source node UUID"),
+    target_node_id: z.string().describe("Target node UUID"),
+    relationship_type: z
+      .string()
+      .describe("Edge type (relates-to, part-of, supersedes, etc.)"),
+    weight: z.number().optional().describe("Relevance weight (default 1.0)"),
+    created_by: z.string().optional().describe("Creator identifier"),
+  },
+  async ({ source_node_id, target_node_id, relationship_type, weight, created_by }) => {
+    const edge = await edgeService.create({
+      sourceNodeId: source_node_id,
+      targetNodeId: target_node_id,
+      relationshipType: relationship_type,
+      weight,
+      createdBy: created_by ?? "mcp",
+    });
+    return {
+      content: [
+        { type: "text" as const, text: JSON.stringify(edge, null, 2) },
+      ],
+    };
+  }
+);
+
+server.tool(
+  "set_status",
+  "Change node status (draft/reviewed/approved/archived)",
+  {
+    id: z.string().describe("Node UUID"),
+    status: z
+      .enum(["draft", "reviewed", "approved", "archived"])
+      .describe("New status"),
+  },
+  async ({ id, status }) => {
+    const node = await nodeService.setStatus(id, status as NodeStatus);
+    if (!node) {
+      return {
+        content: [{ type: "text" as const, text: "Node not found" }],
+        isError: true,
+      };
+    }
+    return {
+      content: [
+        { type: "text" as const, text: JSON.stringify(node, null, 2) },
+      ],
+    };
+  }
+);
+
+// ── Start Server ───────────────────────────────────────────────────────────
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("Apart Intelligence MCP server running on stdio");
+}
+
+main().catch((err) => {
+  console.error("Failed to start MCP server:", err);
+  process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"]
+}