@dudamel/mcp-context 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,114 @@
+/**
+ * The MCP speaks to the VFS in one of two modes:
+ *
+ *   - direct: hits the private context-server HTTP API (default inside compose).
+ *   - proxy:  goes through the orchestrator's authenticated /api/context/*
+ *             routes. Required for remote use (Claude Code on a laptop, etc.).
+ */
+export interface McpContextConfigDirect {
+    mode: 'direct';
+    baseUrl: string;
+}
+export interface McpContextConfigProxy {
+    mode: 'proxy';
+    /** Orchestrator base URL (e.g. https://dudamel.example.com). The MCP appends "/api/context". */
+    baseUrl: string;
+    /** API key sent on every request. */
+    apiKey: string;
+}
+export type McpContextConfig = McpContextConfigDirect | McpContextConfigProxy;
+/** One entry in a directory's .index.yaml catalog. */
+export interface CatalogEntry {
+    path: string;
+    type: 'file' | 'directory';
+    description: string;
+}
+export interface DirectoryCatalog {
+    description: string;
+    entries: CatalogEntry[];
+}
+export interface FileReadResponse {
+    content: string;
+    size: number;
+    path: string;
+}
+export interface GrepHit {
+    path: string;
+    line: number;
+    text: string;
+}
+export interface SearchResult<T> {
+    results: T[];
+    truncated: boolean;
+}
+export interface StatResponse {
+    exists: boolean;
+    type?: 'file' | 'directory' | 'other';
+    size?: number;
+    lines?: number;
+    entries?: number;
+    modified?: string;
+}
+export interface TreeEntry {
+    path: string;
+    type: 'file' | 'directory';
+    depth: number;
+}
+export interface TreeResponse {
+    root: string;
+    entries: TreeEntry[];
+    truncated: boolean;
+}
+export interface TailResponse {
+    content: string;
+    returnedLines: number;
+    size: number;
+    exists: boolean;
+}
+export interface MarkdownHeading {
+    line: number;
+    level: number;
+    text: string;
+}
+export interface ReadSectionResponse {
+    exists: boolean;
+    headings: MarkdownHeading[];
+    match?: {
+        heading: MarkdownHeading;
+        startLine: number;
+        endLine: number;
+        content: string;
+        ambiguousMatches?: number;
+    };
+}
+export interface YamlKeyEntry {
+    key: string;
+    type: 'string' | 'number' | 'boolean' | 'null' | 'array' | 'object';
+    preview: string;
+}
+export interface ReadYamlResponse {
+    exists: boolean;
+    keys: YamlKeyEntry[];
+    match?: {
+        keyPath: string;
+        type: 'string' | 'number' | 'boolean' | 'null' | 'array' | 'object';
+        content: string;
+    };
+}
+export interface CsvColumn {
+    name: string;
+    index: number;
+}
+export interface ReadCsvResponse {
+    exists: boolean;
+    headers: CsvColumn[];
+    totalRows: number;
+    rows: Record<string, string>[];
+    truncated: boolean;
+    filterApplied?: {
+        column: string;
+        value: string;
+        matchedRows: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,gGAAgG;IAChG,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,GAAG,qBAAqB,CAAC;AAE9E,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,eAAe,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;QACpE,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CACxE"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@dudamel/mcp-context",
+  "version": "0.1.0",
+  "description": "Dudamel Context MCP — stdio client for an org's Dudamel knowledge base (VFS) over its REST API.",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "dudamel-mcp-context": "./dist/stdio-server.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agents-squad/dudamel.git",
+    "directory": "packages/mcp/context"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "js-yaml": "^4.1.0",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/js-yaml": "^4.0.9"
+  },
+  "peerDependencies": {
+    "express": "^4.18.0 || ^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist"
+  }
+}