@attrove/mcp 0.1.3 → 0.1.5

package/esm/src/version.js

@@ -0,0 +1,137 @@
+/**
+ * MCP Server Version Utilities
+ *
+ * Reads the version from package.json at runtime to ensure the reported
+ * version always matches the published package version.
+ *
+ * Uses a cross-platform approach that works in both ESM and CJS environments
+ * by parsing Error stack traces to determine the current file location.
+ */
+import { existsSync, readFileSync } from 'fs';
+import { dirname, join, resolve } from 'path';
+import { fileURLToPath } from 'url';
+/**
+ * Fallback version used when package.json cannot be read.
+ * This should only happen in unusual development environments.
+ */
+const FALLBACK_VERSION = '0.0.0-unknown';
+/**
+ * Cached version string to avoid repeated file reads.
+ */
+let cachedVersion;
+/**
+ * Get the directory of the current file using Error stack trace parsing.
+ * Works in both ESM and CJS environments without relying on __dirname or import.meta.url.
+ */
+function getCurrentDirectory() {
+    const err = new Error();
+    const stack = err.stack || '';
+    // Stack trace line patterns:
+    // Node CJS: "    at Function.<anonymous> (/path/to/file.js:10:15)"
+    // Node ESM: "    at file:///path/to/file.js:10:15"
+    // Also handles: "    at /path/to/file.js:10:15"
+    const lines = stack.split('\n');
+    for (const line of lines) {
+        // Skip the Error message line and this function's frame
+        if (!line.includes('getCurrentDirectory') && !line.startsWith('Error')) {
+            // Match file:// URLs (ESM)
+            const fileUrlMatch = line.match(/file:\/\/([^:]+):\d+:\d+/);
+            if (fileUrlMatch) {
+                try {
+                    const filePath = fileURLToPath(`file://${fileUrlMatch[1]}`);
+                    return dirname(filePath);
+                }
+                catch {
+                    // Continue to next pattern
+                }
+            }
+            // Match parenthesized paths: "at Something (/path/to/file.js:10:15)"
+            const parenMatch = line.match(/\(([^)]+):\d+:\d+\)/);
+            if (parenMatch && !parenMatch[1].startsWith('node:')) {
+                return dirname(parenMatch[1]);
+            }
+            // Match bare paths: "at /path/to/file.js:10:15"
+            const bareMatch = line.match(/at\s+([^:]+):\d+:\d+/);
+            if (bareMatch && !bareMatch[1].startsWith('node:') && !bareMatch[1].includes('(')) {
+                return dirname(bareMatch[1].trim());
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Search for package.json with the correct package name starting from a directory.
+ */
+function findPackageJson(startDir, packageName) {
+    let dir = startDir;
+    const visited = new Set();
+    while (dir && !visited.has(dir)) {
+        visited.add(dir);
+        const pkgPath = join(dir, 'package.json');
+        if (existsSync(pkgPath)) {
+            try {
+                const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+                if (pkg.name === packageName && pkg.version) {
+                    return pkg.version;
+                }
+            }
+            catch {
+                // Continue searching
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+/**
+ * Get the MCP server version from package.json.
+ *
+ * This function reads the version at runtime from the package.json file,
+ * ensuring the MCP server always reports the correct published version
+ * to clients.
+ *
+ * The version is cached after the first read for performance.
+ */
+export function getVersion() {
+    if (cachedVersion !== undefined) {
+        return cachedVersion;
+    }
+    const packageName = '@attrove/mcp';
+    // Try to find package.json starting from the current file's directory
+    const currentDir = getCurrentDirectory();
+    if (currentDir) {
+        const version = findPackageJson(currentDir, packageName);
+        if (version) {
+            cachedVersion = version;
+            return version;
+        }
+    }
+    // Fallback: search from common locations relative to process.cwd()
+    const fallbackPaths = [
+        resolve(process.cwd(), 'packages/mcp'),
+        resolve(process.cwd(), 'node_modules/@attrove/mcp'),
+        process.cwd(),
+    ];
+    for (const searchPath of fallbackPaths) {
+        if (existsSync(searchPath)) {
+            const version = findPackageJson(searchPath, packageName);
+            if (version) {
+                cachedVersion = version;
+                return version;
+            }
+        }
+    }
+    // If we can't find package.json, use the fallback
+    cachedVersion = FALLBACK_VERSION;
+    return FALLBACK_VERSION;
+}
+/**
+ * Reset the cached version. Primarily for testing purposes.
+ */
+export function resetVersionCache() {
+    cachedVersion = undefined;
+}
+//# sourceMappingURL=version.js.map

package/esm/src/version.js.map

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

package/package.json

@@ -1,27 +1,29 @@
 {
   "name": "@attrove/mcp",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "MCP server for Attrove - AI-powered context retrieval for Claude and Cursor",
-  "main": "./dist/cjs/index.js",
-  "module": "./dist/esm/index.js",
-  "types": "./dist/types/index.d.ts",
+  "main": "./cjs/src/index.js",
+  "module": "./esm/src/index.js",
+  "types": "./types/src/index.d.ts",
   "bin": {
     "attrove-mcp": "./bin/attrove-mcp.js"
   },
   "exports": {
     ".": {
       "import": {
-        "types": "./dist/types/index.d.ts",
-        "default": "./dist/esm/index.js"
+        "types": "./types/src/index.d.ts",
+        "default": "./esm/src/index.js"
       },
       "require": {
-        "types": "./dist/types/index.d.ts",
-        "default": "./dist/cjs/index.js"
+        "types": "./types/src/index.d.ts",
+        "default": "./cjs/src/index.js"
       }
     }
   },
   "files": [
-    "dist",
+    "cjs",
+    "esm",
+    "types",
     "bin",
     "README.md"
   ],
@@ -56,7 +58,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "@attrove/sdk": "*"
+    "@attrove/sdk": "0.1.5"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
@@ -65,4 +67,4 @@
   "publishConfig": {
     "access": "public"
   }
-}
+}

package/types/src/__mocks__/version.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Mock version module for Jest tests.
+ *
+ * This avoids the import.meta.url ESM issue when running tests with ts-jest.
+ */
+export declare function getVersion(): string;
+export declare function resetVersionCache(): void;

package/types/src/constants.d.ts

@@ -0,0 +1,13 @@
+/**
+ * MCP Constants
+ *
+ * Centralized constants used across the MCP server. Consolidating these ensures
+ * consistency and makes maintenance easier.
+ */
+/**
+ * Maximum length for message body preview text in search results.
+ *
+ * When displaying search results, message bodies longer than this value
+ * will be truncated with an ellipsis to keep output manageable.
+ */
+export declare const MAX_BODY_PREVIEW_LENGTH = 200;

package/types/src/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @attrove/mcp
+ *
+ * MCP server for Attrove - enables AI assistants like Claude and Cursor
+ * to access user context through the Attrove API.
+ *
+ * @example
+ * ```bash
+ * # Run via npx
+ * ATTROVE_API_KEY=sk_... ATTROVE_USER_ID=... npx @attrove/mcp
+ *
+ * # Configure in Claude Desktop
+ * {
+ *   "mcpServers": {
+ *     "attrove": {
+ *       "command": "npx",
+ *       "args": ["@attrove/mcp"],
+ *       "env": {
+ *         "ATTROVE_API_KEY": "sk_...",
+ *         "ATTROVE_USER_ID": "..."
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { createServer, startServer, getConfigFromEnv } from './server';
+export type { McpServerConfig } from './server';
+export { allToolDefinitions, queryToolDefinition, searchToolDefinition, integrationsToolDefinition, } from './tools';
+export { getVersion } from './version';

package/types/src/server.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Attrove MCP Server
+ *
+ * Model Context Protocol server that enables AI assistants like Claude
+ * to access user context through the Attrove API.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+/**
+ * Configuration for the MCP server.
+ */
+export interface McpServerConfig {
+    /**
+     * Attrove API key (sk_ prefixed).
+     */
+    apiKey: string;
+    /**
+     * User ID (UUID) to scope API calls.
+     */
+    userId: string;
+    /**
+     * Optional API base URL.
+     */
+    baseUrl?: string;
+}
+/**
+ * Create and configure the Attrove MCP server.
+ */
+export declare function createServer(config: McpServerConfig): Server;
+/**
+ * Start the MCP server with stdio transport.
+ */
+export declare function startServer(config: McpServerConfig): Promise<void>;
+/**
+ * Get configuration from environment variables.
+ *
+ * @throws {Error} If required environment variables are missing
+ */
+export declare function getConfigFromEnv(): McpServerConfig;

package/types/src/tools/index.d.ts

@@ -0,0 +1,80 @@
+/**
+ * MCP Tools
+ *
+ * Tool definitions and executors for the Attrove MCP server.
+ */
+import { queryToolDefinition, executeQueryTool, QueryToolInput } from './query';
+import { searchToolDefinition, executeSearchTool, SearchToolInput } from './search';
+import { integrationsToolDefinition, executeIntegrationsTool } from './integrations';
+export { queryToolDefinition, executeQueryTool, searchToolDefinition, executeSearchTool, integrationsToolDefinition, executeIntegrationsTool, };
+export type { QueryToolInput, SearchToolInput };
+/**
+ * All tool definitions for registration with MCP.
+ */
+export declare const allToolDefinitions: readonly [{
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            integration_ids: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            include_sources: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+        required: string[];
+    };
+}, {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            after_date: {
+                type: string;
+                description: string;
+            };
+            before_date: {
+                type: string;
+                description: string;
+            };
+            sender_domains: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            include_body_text: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+        required: string[];
+    };
+}, {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+        required: never[];
+    };
+}];

package/types/src/tools/integrations.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Integrations Tool
+ *
+ * MCP tool for listing and managing connected integrations.
+ */
+import { Attrove } from '@attrove/sdk';
+/**
+ * Tool definition for attrove_integrations.
+ */
+export declare const integrationsToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+        required: never[];
+    };
+};
+/**
+ * Execute the integrations tool.
+ */
+export declare function executeIntegrationsTool(client: Attrove): Promise<string>;

package/types/src/tools/query.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Query Tool
+ *
+ * MCP tool for RAG queries against user context.
+ */
+import { Attrove } from '@attrove/sdk';
+/**
+ * Tool definition for attrove_query.
+ */
+export declare const queryToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            integration_ids: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            include_sources: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * Input for the query tool.
+ */
+export interface QueryToolInput {
+    query: string;
+    integration_ids?: string[];
+    include_sources?: boolean;
+}
+/**
+ * Execute the query tool.
+ */
+export declare function executeQueryTool(client: Attrove, input: QueryToolInput): Promise<string>;

package/types/src/tools/search.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Search Tool
+ *
+ * MCP tool for semantic search across user context.
+ */
+import { Attrove } from '@attrove/sdk';
+/**
+ * Tool definition for attrove_search.
+ */
+export declare const searchToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            after_date: {
+                type: string;
+                description: string;
+            };
+            before_date: {
+                type: string;
+                description: string;
+            };
+            sender_domains: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            include_body_text: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * Input for the search tool.
+ */
+export interface SearchToolInput {
+    query: string;
+    after_date?: string;
+    before_date?: string;
+    sender_domains?: string[];
+    include_body_text?: boolean;
+}
+/**
+ * Execute the search tool.
+ */
+export declare function executeSearchTool(client: Attrove, input: SearchToolInput): Promise<string>;

package/types/src/version.d.ts

@@ -0,0 +1,23 @@
+/**
+ * MCP Server Version Utilities
+ *
+ * Reads the version from package.json at runtime to ensure the reported
+ * version always matches the published package version.
+ *
+ * Uses a cross-platform approach that works in both ESM and CJS environments
+ * by parsing Error stack traces to determine the current file location.
+ */
+/**
+ * Get the MCP server version from package.json.
+ *
+ * This function reads the version at runtime from the package.json file,
+ * ensuring the MCP server always reports the correct published version
+ * to clients.
+ *
+ * The version is cached after the first read for performance.
+ */
+export declare function getVersion(): string;
+/**
+ * Reset the cached version. Primarily for testing purposes.
+ */
+export declare function resetVersionCache(): void;