@arizeai/phoenix-mcp 4.1.0 → 4.2.0

package/README.md

@@ -110,6 +110,12 @@ When developing, the server requires the following environment variables:
 
 Make sure to set these in a `.env` file. See `.env.example`.
 
+At runtime the server also discovers the nearest `.env.phoenix` file at or
+above the working directory. Process environment variables and command-line
+options take precedence. If a higher-priority API key is paired with
+`PHOENIX_HOST` from the file, the server warns once and continues. Set
+`PHOENIX_DISCOVER_CONFIG=false` to disable discovery.
+
 ## Tool Coverage
 
 The MCP server covers the main operational Phoenix workflows:

package/build/config.js

@@ -1,18 +1,22 @@
-import { DEFAULT_PHOENIX_BASE_URL, ENV_PHOENIX_API_KEY, ENV_PHOENIX_CLIENT_HEADERS, ENV_PHOENIX_HOST, getHeadersFromEnvironment, getProjectFromEnvironment, getStrFromEnvironment, } from "@arizeai/phoenix-config";
+import { DEFAULT_PHOENIX_BASE_URL, ENV_PHOENIX_HOST, getCredentialsFromEnvironmentWithSource, getProjectFromEnvironment, getStrFromEnvironmentWithSource, warnIfUsingFileEndpointWithCredentials, } from "@arizeai/phoenix-config";
 export const DEFAULT_PHOENIX_ENDPOINT = DEFAULT_PHOENIX_BASE_URL;
-/**
- * Load Phoenix MCP configuration from environment variables.
- */
+/** Load Phoenix MCP configuration from environment variables. */
 export function loadConfigFromEnvironment() {
-    const baseUrl = getStrFromEnvironment(ENV_PHOENIX_HOST);
-    const apiKey = getStrFromEnvironment(ENV_PHOENIX_API_KEY);
-    const headers = getHeadersFromEnvironment(ENV_PHOENIX_CLIENT_HEADERS);
+    return loadConfigFromEnvironmentWithSources().config;
+}
+function loadConfigFromEnvironmentWithSources() {
+    const baseUrl = getStrFromEnvironmentWithSource(ENV_PHOENIX_HOST);
+    const { apiKey, headers, source: credentialSource, } = getCredentialsFromEnvironmentWithSource();
     const project = getProjectFromEnvironment();
     return {
-        baseUrl: baseUrl || DEFAULT_PHOENIX_ENDPOINT,
-        apiKey: apiKey || undefined,
-        headers: headers || undefined,
-        project: project || undefined,
+        config: {
+            baseUrl: baseUrl.value || DEFAULT_PHOENIX_ENDPOINT,
+            apiKey: apiKey || undefined,
+            headers: headers || undefined,
+            project: project || undefined,
+        },
+        credentialSource,
+        endpointSource: baseUrl.source,
     };
 }
 /**
@@ -39,9 +43,24 @@ function getStringCommandLineOptions(commandLineOptions) {
  * parsed by `minimist` do not replace valid environment defaults with boolean `true`.
  */
 export function resolveConfig({ commandLineOptions, }) {
-    const envConfig = loadConfigFromEnvironment();
+    const { config: envConfig, credentialSource, endpointSource, } = loadConfigFromEnvironmentWithSources();
+    const commandLineConfig = getStringCommandLineOptions(commandLineOptions);
+    const usesFileEndpoint = endpointSource?.kind === "env-file" &&
+        commandLineConfig.baseUrl === undefined;
+    const resolvedCredentialSource = commandLineConfig.apiKey !== undefined
+        ? "command-line options"
+        : credentialSource?.kind === "process"
+            ? "the process environment"
+            : undefined;
+    if (usesFileEndpoint) {
+        warnIfUsingFileEndpointWithCredentials({
+            credentialSource: resolvedCredentialSource,
+            endpointSource,
+            endpointVariable: ENV_PHOENIX_HOST,
+        });
+    }
     return {
         ...envConfig,
-        ...getStringCommandLineOptions(commandLineOptions),
+        ...commandLineConfig,
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arizeai/phoenix-mcp",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "description": "A MCP server for Arize Phoenix",
   "keywords": [
     "arize-phoenix",
@@ -28,15 +28,15 @@
     "glob": "^13.0.6",
     "minimist": "^1.2.8",
     "zod": "^4.4.3",
-    "@arizeai/phoenix-client": "6.12.1",
-    "@arizeai/phoenix-config": "0.2.0"
+    "@arizeai/phoenix-client": "6.13.0",
+    "@arizeai/phoenix-config": "0.4.0"
   },
   "devDependencies": {
     "@types/glob": "^9.0.0",
     "@types/minimist": "^1.2.5",
-    "@types/node": "^25.9.4",
-    "tsx": "^4.22.5",
-    "vitest": "^4.1.9"
+    "@types/node": "^26.1.1",
+    "tsx": "^4.23.0",
+    "vitest": "^4.1.10"
   },
   "scripts": {
     "build": "tsc && chmod 755 build/index.js",