@code-context-engine/mcp 0.1.4 → 0.1.6

package/README.md

@@ -46,6 +46,7 @@ No `CONTEXT_ENGINE_REMOTE_URL` needed — defaults to `https://api.codesay.ai`.
 | `CONTEXT_ENGINE_REMOTE_API_KEY` | yes | — | User API key (`cek_…`) from the web console |
 | `CONTEXT_ENGINE_REMOTE_URL` | no | `https://api.codesay.ai` | Remote HTTP service base URL |
 | `CONTEXT_ENGINE_REMOTE_MAX_FILE_BYTES` | no | `1048576` | Skip local files larger than this when syncing |
+| `CONTEXT_ENGINE_REMOTE_TIMEOUT_MS` | no | `120000` | Per-request HTTP timeout (ms); raise for first sync of large repos |
 
 ## Tool: `codebase_context`
 

package/dist/codebaseContext.d.ts

@@ -14,6 +14,8 @@ export interface CodebaseContextInput {
     /** 本地文件发现的单文件大小上限(字节),应与远程服务的 CONTEXT_ENGINE_REMOTE_MAX_FILE_BYTES 一致——
      * 否则本地判断"该传"的文件会在上传时被服务端按 413 拒绝。 */
     maxFileBytes?: number;
+    /** 单次远程 HTTP 请求超时(毫秒),默认 120s。首次同步大仓库可通过 MCP env 调大。 */
+    timeoutMs?: number;
     feedback?: CodebaseContextFeedbackInput;
 }
 export interface CodebaseContextFeedbackInput {

package/dist/codebaseContext.js

@@ -32,7 +32,11 @@ export async function runCodebaseContext(input) {
     if (!isAbsolute(input.path)) {
         throw new CodebaseContextInputError('Use an absolute local repository path.');
     }
-    const client = new RemoteApiClient({ baseUrl: input.baseUrl, apiKey: input.apiKey });
+    const client = new RemoteApiClient({
+        baseUrl: input.baseUrl,
+        apiKey: input.apiKey,
+        timeoutMs: input.timeoutMs,
+    });
     const sync = await syncLocalRepo(client, input.path, {
         ignoreGlobs: input.ignoreGlobs,
         forceIndex: input.forceIndex,

package/dist/remoteClient.d.ts

@@ -79,6 +79,7 @@ export interface RemoteFeedbackEvalResult {
     on: EvalReport;
     quality: FeedbackQualitySummary;
 }
+export declare function resolveRemoteTimeoutMs(env?: NodeJS.ProcessEnv): number;
 export declare class RemoteApiClient {
     private opts;
     private baseUrl;

package/dist/remoteClient.js

@@ -107,7 +107,11 @@ function mapActiveTrainingModel(r) {
         activatedBy: r.activated_by,
     };
 }
-const DEFAULT_TIMEOUT_MS = 30_000;
+const DEFAULT_TIMEOUT_MS = 120_000;
+export function resolveRemoteTimeoutMs(env = process.env) {
+    const n = Number(env.CONTEXT_ENGINE_REMOTE_TIMEOUT_MS ?? DEFAULT_TIMEOUT_MS);
+    return Number.isFinite(n) && n > 0 ? n : DEFAULT_TIMEOUT_MS;
+}
 export class RemoteApiClient {
     opts;
     baseUrl;

package/dist/remoteMcpServer.js

@@ -2,12 +2,13 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
+import { realpathSync } from 'node:fs';
 import { isAbsolute } from 'node:path';
-import { pathToFileURL } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 import { loadConfig, resolveRemoteUrl } from '@code-context-engine/shared';
 import { CodebaseContextInputError, runCodebaseContext } from './codebaseContext.js';
-import { RemoteApiError, remoteQuotaErrorMessage } from './remoteClient.js';
-import { SyncLocalRepoInputError } from './syncLocalRepo.js';
+import { RemoteApiError, remoteQuotaErrorMessage, resolveRemoteTimeoutMs } from './remoteClient.js';
+import { RemoteIndexError, SyncLocalRepoInputError } from './syncLocalRepo.js';
 const ok = (data) => ({
     content: [{ type: 'text', text: JSON.stringify(data) }],
     structuredContent: data,
@@ -74,10 +75,42 @@ const codebaseContextOutputSchema = z.object({
         }).strict().optional(),
     }).strict(),
 }).strict();
+function isTimeoutError(err) {
+    if (!err || typeof err !== 'object')
+        return false;
+    const name = err.name;
+    return name === 'TimeoutError' || name === 'AbortError';
+}
+function isNetworkError(err) {
+    if (!(err instanceof TypeError))
+        return false;
+    const cause = err.cause;
+    if (cause && typeof cause === 'object' && 'code' in cause) {
+        const code = cause.code;
+        return typeof code === 'string' && (code === 'ENOTFOUND'
+            || code === 'ECONNREFUSED'
+            || code === 'ECONNRESET'
+            || code === 'ETIMEDOUT'
+            || code === 'UND_ERR_CONNECT_TIMEOUT');
+    }
+    return /fetch failed/i.test(err.message);
+}
 function publicRemoteErrorMessage(err) {
     if (err instanceof CodebaseContextInputError || err instanceof SyncLocalRepoInputError) {
         return `codebase_context input invalid: ${err.message}`;
     }
+    if (err instanceof RemoteIndexError) {
+        return `Remote Context Engine request failed: indexing_failed. ${err.message.replace(/^Remote indexing failed:\s*/i, '')}`;
+    }
+    if (isTimeoutError(err)) {
+        return 'Remote Context Engine request failed: request_timeout. '
+            + 'The remote service did not respond in time (often during the first sync of a large repository). '
+            + 'Retry the same query, or raise CONTEXT_ENGINE_REMOTE_TIMEOUT_MS in MCP env.';
+    }
+    if (isNetworkError(err)) {
+        return 'Remote Context Engine request failed: network_error. '
+            + 'Could not reach the remote service. Check network access to api.codesay.ai and retry.';
+    }
     if (err instanceof RemoteApiError) {
         if (err.status === 401 || err.status === 403) {
             return 'Remote Context Engine request failed: authentication_failed. Check the local MCP API key configuration.';
@@ -85,9 +118,15 @@ function publicRemoteErrorMessage(err) {
         if (err.status === 402) {
             return remoteQuotaErrorMessage(err);
         }
+        if (err.status === 404) {
+            return 'Remote Context Engine request failed: not_found. The remote repository or endpoint is missing. Retry after sync completes.';
+        }
         if (err.status === 413) {
             return 'Remote Context Engine request failed: payload_too_large. Reduce ignored files or split the repository, then retry.';
         }
+        if (err.status === 429) {
+            return 'Remote Context Engine request failed: rate_limited. Wait a moment and retry.';
+        }
         if (err.status === 400) {
             return 'Remote Context Engine request failed: invalid_request. Check the local MCP input and repository sync settings.';
         }
@@ -112,7 +151,7 @@ export function createRemoteMcpServer() {
         },
     }, async ({ path, query, token_budget, mode, ext_filter, path_prefix, max_files, feedback, }) => {
         const baseUrl = resolveRemoteUrl();
-        const key = cfg.remote.apiKey;
+        const key = process.env.CONTEXT_ENGINE_REMOTE_API_KEY?.trim() || cfg.remote.apiKey;
         if (!key)
             throw new Error('Remote Context Engine is not configured. Contact the server operator.');
         try {
@@ -127,6 +166,7 @@ export function createRemoteMcpServer() {
                 pathPrefix: path_prefix,
                 maxFiles: max_files,
                 maxFileBytes: cfg.remote.maxFileBytes,
+                timeoutMs: resolveRemoteTimeoutMs(),
                 feedback: feedback ? {
                     rating: feedback.rating,
                     requestId: feedback.request_id,
@@ -143,7 +183,18 @@ export function createRemoteMcpServer() {
 async function main() {
     await createRemoteMcpServer().connect(new StdioServerTransport());
 }
-if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+function isExecutedDirectly() {
+    const entry = process.argv[1];
+    if (!entry)
+        return false;
+    try {
+        return realpathSync(fileURLToPath(import.meta.url)) === realpathSync(entry);
+    }
+    catch {
+        return import.meta.url === pathToFileURL(entry).href;
+    }
+}
+if (isExecutedDirectly()) {
     main().catch((err) => {
         console.error(err);
         process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@code-context-engine/mcp",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "MCP server that gives Claude Code, Cursor, and any MCP client real codebase context without burning tokens — incremental sync, hybrid dense+sparse+symbol-graph retrieval, token-budgeted context packs.",
   "license": "MIT",
   "homepage": "https://codesay.ai",