midnight-mcp 0.2.21 → 0.3.0

package/README.md

@@ -1,5 +1,14 @@
 # Midnight MCP Server
 
+> ## ⚠️ Deprecated — use Kapa + Midnight Expert
+>
+> **midnight-mcp is being wound down.** Midnight has standardised on two official tools:
+>
+> - **Kapa MCP** (docs Q&A / search): `claude mcp add --transport http midnight https://midnight.mcp.kapa.ai`
+> - **Midnight Expert** (hands-on dev, Claude Code plugins): `curl -fsSL https://midnightntwrk.expert/install.sh | bash`
+>
+> **Migration guide → https://docs.midnight.network/blog/migrating-to-kapa-and-midnight-expert**
+
 [![npm version](https://badge.fury.io/js/midnight-mcp.svg)](https://www.npmjs.com/package/midnight-mcp)
 [![npm downloads](https://img.shields.io/npm/dm/midnight-mcp)](https://npm-stat.com/charts.html?package=midnight-mcp)
 [![License](https://img.shields.io/npm/l/midnight-mcp)](./LICENSE)

package/dist/bin.js

@@ -2,10 +2,10 @@
 import {
   startHttpServer,
   startServer
-} from "./chunk-T2CXHJAO.js";
+} from "./chunk-VBZPDFKP.js";
 import {
   setOutputFormat
-} from "./chunk-YDH6CRK3.js";
+} from "./chunk-KRDOSQPS.js";
 
 // src/bin.ts
 import { config } from "dotenv";
@@ -13,7 +13,7 @@ import { resolve } from "path";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
 config({ path: resolve(process.cwd(), ".env") });
-var CURRENT_VERSION = "0.2.21";
+var CURRENT_VERSION = "0.3.0";
 process.on("uncaughtException", (error) => {
   console.error("Uncaught exception:", error);
   process.exit(1);

package/dist/{chunk-YDH6CRK3.js → chunk-KRDOSQPS.js}

@@ -10,8 +10,16 @@ var ConfigSchema = z.object({
   mode: z.enum(["hosted", "local"]).default("hosted"),
   // Hosted API URL (used when mode is 'hosted')
   hostedApiUrl: z.string().default("https://midnight-mcp-api.midnightmcp.workers.dev"),
+  // Optional bearer token sent to the hosted API. Needed when pointing
+  // MIDNIGHT_API_URL at a private/self-hosted backend that requires auth.
+  hostedApiToken: z.string().optional(),
   // GitHub
   githubToken: z.string().optional(),
+  // Extra GitHub repo owners allowed for the resolveRepo() org/repo
+  // fall-through, on top of the built-in vetted list. Comma-separated via
+  // MIDNIGHT_MCP_ALLOWED_REPO_OWNERS. Lets local users add their own repos
+  // without reopening arbitrary-repo access.
+  allowedRepoOwners: z.array(z.string()).default([]),
   // Vector Database (only needed for local mode)
   chromaUrl: z.string().default("http://localhost:8000"),
   // Embeddings (only needed for local mode)
@@ -31,7 +39,9 @@ function loadConfig() {
   const rawConfig = {
     mode: isLocalMode2 ? "local" : "hosted",
     hostedApiUrl: process.env.MIDNIGHT_API_URL,
+    hostedApiToken: process.env.MIDNIGHT_API_TOKEN,
     githubToken: process.env.GITHUB_TOKEN,
+    allowedRepoOwners: process.env.MIDNIGHT_MCP_ALLOWED_REPO_OWNERS ? process.env.MIDNIGHT_MCP_ALLOWED_REPO_OWNERS.split(",").map((s) => s.trim()).filter(Boolean) : void 0,
     chromaUrl: process.env.CHROMA_URL,
     openaiApiKey: process.env.OPENAI_API_KEY,
     embeddingModel: process.env.EMBEDDING_MODEL,
@@ -1624,7 +1634,7 @@ var releaseTracker = new ReleaseTracker();
 
 // src/utils/health.ts
 var startTime = Date.now();
-var VERSION = "0.2.21";
+var VERSION = "0.3.0";
 async function checkGitHubAPI() {
   const start = Date.now();
   try {
@@ -1652,7 +1662,7 @@ async function checkGitHubAPI() {
 }
 async function checkVectorStore() {
   try {
-    const { vectorStore: vectorStore2 } = await import("./db-5GTR4PCW.js");
+    const { vectorStore: vectorStore2 } = await import("./db-3WSIJCLE.js");
     if (vectorStore2) {
       return {
         status: "pass",
@@ -1999,6 +2009,9 @@ async function makeRequest(url, endpoint, options) {
       headers: {
         "Content-Type": "application/json",
         "User-Agent": "midnight-mcp",
+        // Send bearer auth when the backend requires it (private/self-hosted
+        // deployments that set MIDNIGHT_API_TOKEN).
+        ...config.hostedApiToken ? { Authorization: `Bearer ${config.hostedApiToken}` } : {},
         ...options.headers
       }
     });
@@ -2118,7 +2131,7 @@ function serialize(data) {
 }
 
 // src/utils/version.ts
-var CURRENT_VERSION = "0.2.21";
+var CURRENT_VERSION = "0.3.0";
 
 // src/db/vectorStore.ts
 var VectorStore = class {
@@ -2313,6 +2326,7 @@ var VectorStore = class {
 var vectorStore = new VectorStore();
 
 export {
+  config,
   isHostedMode,
   DEFAULT_REPOSITORIES,
   setMCPLogCallback,
@@ -2340,4 +2354,4 @@ export {
   serialize,
   CURRENT_VERSION
 };
-//# sourceMappingURL=chunk-YDH6CRK3.js.map
+//# sourceMappingURL=chunk-KRDOSQPS.js.map

package/dist/{chunk-T2CXHJAO.js → chunk-VBZPDFKP.js}

@@ -2,6 +2,7 @@ import {
   CURRENT_VERSION,
   DEFAULT_REPOSITORIES,
   SelfCorrectionHints,
+  config,
   createCacheKey,
   fileCache,
   formatErrorResponse,
@@ -24,7 +25,7 @@ import {
   validateNumber,
   validateQuery,
   vectorStore
-} from "./chunk-YDH6CRK3.js";
+} from "./chunk-KRDOSQPS.js";
 
 // src/tools/search/schemas.ts
 import { z } from "zod";
@@ -170,43 +171,43 @@ function finalizeResponse(response, cacheKey, warnings) {
   });
   return finalResponse;
 }
-async function performSearch(query, limit, config) {
+async function performSearch(query, limit, config2) {
   const validation = validateSearchInput(query, limit);
   if (!validation.success) {
     return validation.error;
   }
   const { sanitizedQuery, limit: validatedLimit, warnings } = validation.context;
-  logger.debug(`Searching ${config.searchType}`, {
+  logger.debug(`Searching ${config2.searchType}`, {
     query: sanitizedQuery,
     mode: isHostedMode() ? "hosted" : "local"
   });
   const cacheKey = createCacheKey(
-    config.searchType,
+    config2.searchType,
     sanitizedQuery,
     validatedLimit,
-    ...config.cacheKeyExtra
+    ...config2.cacheKeyExtra
   );
   const cached = checkSearchCache(cacheKey);
   if (cached) return cached;
   const hostedResult = await tryHostedSearch(
-    config.searchType,
-    () => config.hostedSearchFn(sanitizedQuery, validatedLimit),
+    config2.searchType,
+    () => config2.hostedSearchFn(sanitizedQuery, validatedLimit),
     cacheKey,
     warnings
   );
   if (hostedResult) {
-    return { ...hostedResult.result, ...config.hostedResultExtra };
+    return { ...hostedResult.result, ...config2.hostedResultExtra };
   }
-  const filter = config.buildFilter();
+  const filter = config2.buildFilter();
   let results = await vectorStore.search(sanitizedQuery, validatedLimit, filter);
-  if (config.postFilter) {
-    results = config.postFilter(results);
+  if (config2.postFilter) {
+    results = config2.postFilter(results);
   }
   const response = {
-    results: results.map(config.transformResult),
+    results: results.map(config2.transformResult),
     totalResults: results.length,
     query: sanitizedQuery,
-    ...config.extraFields
+    ...config2.extraFields
   };
   return finalizeResponse(response, cacheKey, warnings);
 }
@@ -719,7 +720,10 @@ var CompileContractInputSchema = z2.object({
 });
 
 // src/services/compiler.ts
-var COMPILER_API_URL = process.env.COMPACT_COMPILER_URL || "https://compact-playground.up.railway.app";
+function getConfiguredCompilerUrl() {
+  const url = process.env.COMPACT_COMPILER_URL?.trim();
+  return url ? url : void 0;
+}
 var COMPILER_TIMEOUT = 3e4;
 var MAX_CODE_SIZE = 100 * 1024;
 async function compileContract(code, options = {}) {
@@ -739,6 +743,15 @@ async function compileContract(code, options = {}) {
       serviceAvailable: true
     };
   }
+  const url = getConfiguredCompilerUrl();
+  if (!url) {
+    return {
+      success: false,
+      message: "No compiler service configured. Set COMPACT_COMPILER_URL to a compiler you run yourself to enable compilation; contract source is not sent to any third-party by default.",
+      error: "COMPILER_NOT_CONFIGURED",
+      serviceAvailable: false
+    };
+  }
   const controller = new AbortController();
   const timeoutId = setTimeout(() => controller.abort(), COMPILER_TIMEOUT);
   try {
@@ -754,7 +767,7 @@ async function compileContract(code, options = {}) {
       codeLength: code.length,
       options: requestBody.options
     });
-    const response = await fetch(`${COMPILER_API_URL}/compile`, {
+    const response = await fetch(`${url}/compile`, {
       method: "POST",
       headers: {
         "Content-Type": "application/json"
@@ -857,7 +870,7 @@ async function compileContract(code, options = {}) {
   }
 }
 function getCompilerUrl() {
-  return COMPILER_API_URL;
+  return getConfiguredCompilerUrl();
 }
 
 // src/tools/analyze/handlers.ts
@@ -6407,38 +6420,7 @@ var versionCheckResult = {
 var toolCallCount = 0;
 var VERSION_CHECK_INTERVAL = 10;
 async function checkForUpdates() {
-  try {
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), 5e3);
-    const response = await fetch(
-      "https://registry.npmjs.org/midnight-mcp/latest",
-      { signal: controller.signal }
-    );
-    clearTimeout(timeoutId);
-    if (!response.ok) return;
-    const data = await response.json();
-    const latestVersion = data.version;
-    if (latestVersion !== CURRENT_VERSION) {
-      versionCheckResult = {
-        isOutdated: true,
-        latestVersion,
-        lastChecked: Date.now(),
-        updateMessage: `\u{1F6A8} UPDATE AVAILABLE: v${latestVersion} (you have v${CURRENT_VERSION})`
-      };
-      logger.warn(
-        `Outdated version detected: v${CURRENT_VERSION} -> v${latestVersion}`
-      );
-    } else {
-      versionCheckResult = {
-        ...versionCheckResult,
-        lastChecked: Date.now()
-      };
-    }
-  } catch (error) {
-    logger.debug("Version check failed (non-blocking)", {
-      error: error instanceof Error ? error.message : String(error)
-    });
-  }
+  return;
 }
 function maybeCheckForUpdates() {
   toolCallCount++;
@@ -6663,13 +6645,14 @@ function registerCompletionsHandler(server) {
     };
   });
 }
+var DEPRECATION_PREFIX = "[DEPRECATED] midnight-mcp is being retired \u2014 use Kapa (docs Q&A) + Midnight Expert (dev): https://docs.midnight.network/blog/migrating-to-kapa-and-midnight-expert \u2014 ";
 function registerToolHandlers(server) {
   server.setRequestHandler(ListToolsRequestSchema, async () => {
     logger.debug("Listing tools");
     return {
       tools: allTools.map((tool) => ({
         name: tool.name,
-        description: tool.description,
+        description: DEPRECATION_PREFIX + tool.description,
         inputSchema: tool.inputSchema,
         // Include output schema if defined
         ...tool.outputSchema && { outputSchema: tool.outputSchema },
@@ -7866,19 +7849,29 @@ async function extractContractStructure(input) {
 }
 
 // src/tools/repository/handlers.ts
+var ALLOWED_REPO_OWNERS = new Set(
+  [
+    ...Object.values(REPO_ALIASES).map((a) => a.owner),
+    ...DEFAULT_REPOSITORIES.map((r) => r.owner),
+    ...config.allowedRepoOwners
+  ].map((owner) => owner.toLowerCase())
+);
 function resolveRepo(repoName) {
   const name = repoName || "compact";
   const normalized = name.toLowerCase().replace(/^midnightntwrk\//, "");
   const alias = REPO_ALIASES[normalized];
   if (alias) return alias;
-  for (const config of DEFAULT_REPOSITORIES) {
-    if (config.repo.toLowerCase() === normalized) {
-      return { owner: config.owner, repo: config.repo };
+  for (const config2 of DEFAULT_REPOSITORIES) {
+    if (config2.repo.toLowerCase() === normalized) {
+      return { owner: config2.owner, repo: config2.repo };
     }
   }
   if (name.includes("/")) {
     const [owner, repo] = name.split("/");
-    return { owner, repo };
+    if (owner && repo && ALLOWED_REPO_OWNERS.has(owner.toLowerCase())) {
+      return { owner, repo };
+    }
+    return null;
   }
   return null;
 }
@@ -9453,6 +9446,17 @@ async function getStatus(_input) {
     }
   };
 }
+function isNewerVersion(candidate, base) {
+  const a = candidate.split(".").map((n) => parseInt(n, 10) || 0);
+  const b = base.split(".").map((n) => parseInt(n, 10) || 0);
+  for (let i = 0; i < 3; i++) {
+    const x = a[i] ?? 0;
+    const y = b[i] ?? 0;
+    if (x > y) return true;
+    if (x < y) return false;
+  }
+  return false;
+}
 async function checkVersion(_input) {
   try {
     const response = await fetch(
@@ -9469,24 +9473,22 @@ async function checkVersion(_input) {
     }
     const data = await response.json();
     const latestVersion = data.version;
-    const isUpToDate = CURRENT_VERSION === latestVersion;
+    const isUpToDate = !isNewerVersion(latestVersion, CURRENT_VERSION);
     const result = {
       currentVersion: CURRENT_VERSION,
       latestVersion,
       isUpToDate,
-      message: isUpToDate ? "\u2705 You are running the latest version!" : `\u26A0\uFE0F UPDATE AVAILABLE: v${latestVersion} (you have v${CURRENT_VERSION})`
+      message: isUpToDate ? "\u2705 You are running the latest published version. Note: midnight-mcp is deprecated \u2014 migrate to Kapa (docs Q&A) + Midnight Expert (dev): https://docs.midnight.network/blog/migrating-to-kapa-and-midnight-expert" : `\u26A0\uFE0F A newer version (v${latestVersion}) exists, but midnight-mcp is deprecated \u2014 migrate to Kapa (docs Q&A) + Midnight Expert (dev): https://docs.midnight.network/blog/migrating-to-kapa-and-midnight-expert`
     };
     if (!isUpToDate) {
       result.updateInstructions = {
-        step1: "Clear npx cache: rm -rf ~/.npm/_npx (macOS/Linux) or del /s /q %LocalAppData%\\npm-cache\\_npx (Windows)",
-        step2: "Restart Claude Desktop completely (Cmd+Q / Alt+F4, then reopen)",
-        step3: "Or update config to use: npx -y midnight-mcp@latest (forces latest)",
-        alternative: "You can also install globally: npm install -g midnight-mcp@latest"
+        note: "midnight-mcp is deprecated; updating is not recommended.",
+        kapa: "claude mcp add --transport http midnight https://midnight.mcp.kapa.ai",
+        midnightExpert: "curl -fsSL https://midnightntwrk.expert/install.sh | bash",
+        guide: "https://docs.midnight.network/blog/migrating-to-kapa-and-midnight-expert"
       };
       result.newFeatures = [
-        "Auto-update config tool - AI agents update your config automatically",
-        "midnight-extract-contract-structure - Static analysis with 10 pre-compilation checks",
-        "MCP Logging, Progress, Completions capabilities"
+        "midnight-mcp is deprecated \u2014 see the migration guide for the official replacements."
       ];
     }
     return result;
@@ -11239,7 +11241,7 @@ var suggestToolOutputSchema = {
 var metaTools = [
   {
     name: "midnight-list-tool-categories",
-    description: "\u{1F4CB} DISCOVERY TOOL: List available tool categories for progressive exploration. Use this FIRST to understand what capabilities are available, then drill into specific categories with midnight-list-category-tools. Reduces cognitive load by organizing 28 tools into 7 logical groups.",
+    description: "\u{1F4CB} DISCOVERY TOOL: List available tool categories for progressive exploration. Use this FIRST to understand what capabilities are available, then drill into specific categories with midnight-list-category-tools. Reduces cognitive load by organizing the available tools into logical groups.",
     inputSchema: {
       type: "object",
       properties: {
@@ -11332,8 +11334,44 @@ USAGE GUIDANCE:
 ];
 setMetaTools(metaTools);
 
+// src/tools/deprecation/index.ts
+var BLOG_URL = "https://docs.midnight.network/blog/migrating-to-kapa-and-midnight-expert";
+var deprecationTools = [
+  {
+    name: "midnight-new-mcp",
+    description: "Show where midnight-mcp has moved. midnight-mcp is deprecated; Midnight now uses the official Kapa MCP (docs Q&A) and Midnight Expert (hands-on dev). Call this for the install commands and the migration guide.",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    },
+    annotations: {
+      readOnlyHint: true,
+      idempotentHint: true,
+      title: "\u27A1\uFE0F Migrate off midnight-mcp",
+      category: "health"
+    },
+    handler: async () => ({
+      status: "deprecated",
+      message: "midnight-mcp is being retired. Midnight has two official replacements.",
+      kapa: {
+        purpose: "Docs Q&A / search",
+        install: "claude mcp add --transport http midnight https://midnight.mcp.kapa.ai",
+        url: "https://midnight.mcp.kapa.ai"
+      },
+      midnightExpert: {
+        purpose: "Hands-on dev (Claude Code plugins)",
+        install: "curl -fsSL https://midnightntwrk.expert/install.sh | bash",
+        url: "https://midnightntwrk.expert"
+      },
+      guide: BLOG_URL
+    })
+  }
+];
+
 // src/tools/index.ts
 var allTools = [
+  ...deprecationTools,
+  // Redirect to the official replacements, surfaced first
   ...metaTools,
   // Discovery tools first for visibility
   ...searchTools,
@@ -11355,4 +11393,4 @@ export {
   startServer,
   startHttpServer
 };
-//# sourceMappingURL=chunk-T2CXHJAO.js.map
+//# sourceMappingURL=chunk-VBZPDFKP.js.map

package/dist/db-3WSIJCLE.js

@@ -0,0 +1,7 @@
+import {
+  vectorStore
+} from "./chunk-KRDOSQPS.js";
+export {
+  vectorStore
+};
+//# sourceMappingURL=db-3WSIJCLE.js.map

package/dist/index.js

@@ -9,10 +9,10 @@ import {
   promptDefinitions,
   startHttpServer,
   startServer
-} from "./chunk-T2CXHJAO.js";
+} from "./chunk-VBZPDFKP.js";
 import {
   logger
-} from "./chunk-YDH6CRK3.js";
+} from "./chunk-KRDOSQPS.js";
 export {
   allResources,
   allTools,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "midnight-mcp",
-  "version": "0.2.21",
-  "description": "Model Context Protocol Server for Midnight Blockchain Development",
+  "version": "0.3.0",
+  "description": "[DEPRECATED — migrate to Kapa + Midnight Expert: https://docs.midnight.network/blog/migrating-to-kapa-and-midnight-expert] Model Context Protocol Server for Midnight Blockchain Development",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

package/dist/db-5GTR4PCW.js

@@ -1,7 +0,0 @@
-import {
-  vectorStore
-} from "./chunk-YDH6CRK3.js";
-export {
-  vectorStore
-};
-//# sourceMappingURL=db-5GTR4PCW.js.map