@arizeai/phoenix-mcp 2.1.11 → 2.2.0

package/README.md

@@ -14,6 +14,7 @@
 
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://github.com/Arize-ai/phoenix/blob/main/js/packages/phoenix-mcp/LICENSE)
 <img src="https://badge.mcpx.dev?status=on" title="MCP Enabled"/>
+<a href="https://cursor.com/install-mcp?name=phoenix&config=eyJjb21tYW5kIjoibnB4IC15IEBhcml6ZWFpL3Bob2VuaXgtbWNwQGxhdGVzdCAtLWJhc2VVcmwgaHR0cDovL2xvY2FsaG9zdDo2MDA2IC0tYXBpS2V5IHlvdXItYXBpLWtleSJ9"><img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Add Arize Phoenix MCP server to Cursor" height=20 /></a>
 
 Phoenix MCP Server is an implementation of the Model Context Protocol for the Arize Phoenix platform. It provides a unified interface to Phoenix's capabilites.
 
@@ -46,6 +47,7 @@ This MCP server can be used using `npx` and can be directly integrated with clie
       ]
     }
   }
+}
 ```
 
 ## Development

package/build/index.js

@@ -10,6 +10,7 @@ import { initializePromptTools } from "./promptTools.js";
 import { initializeProjectTools } from "./projectTools.js";
 import { initializeSpanTools } from "./spanTools.js";
 import { initializeReadmeResources } from "./readmeResource.js";
+import { initializeSupportTools } from "./supportTools.js";
 const argv = minimist(process.argv.slice(2));
 const headers = argv.apiKey
     ? {
@@ -38,6 +39,7 @@ initializeExperimentTools({ client, server });
 initializeDatasetTools({ client, server });
 initializeProjectTools({ client, server });
 initializeSpanTools({ client, server });
+initializeSupportTools({ server });
 async function main() {
     // Initialize readme resources first
     if (process.env.DANGEROUSLY_READ_README_FILES === "true") {

package/build/supportTools.js

@@ -0,0 +1,73 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import z from "zod";
+const PHOENIX_SUPPORT_DESCRIPTION = `Get help with Phoenix and OpenInference.
+
+- Tracing AI applications via OpenInference and OpenTelemetry
+- Phoenix datasets, experiments, and prompt management
+- Phoenix evals and annotations
+
+Use this tool when you need assistance with Phoenix features, troubleshooting,
+or best practices.
+
+Expected return:
+  Expert guidance about how to use and integrate Phoenix`;
+/**
+ * Creates an MCP client connected to the RunLLM server via HTTP
+ */
+async function createRunLLMClient() {
+    const transport = new StreamableHTTPClientTransport(new URL("https://mcp.runllm.com/mcp/"), {
+        requestInit: {
+            headers: {
+                "assistant-name": "arize-phoenix",
+            },
+        },
+    });
+    const client = new Client({
+        name: "runllm-client",
+        version: "1.0.0",
+    });
+    await client.connect(transport);
+    return client;
+}
+/**
+ * Calls the chat tool on the RunLLM MCP server
+ */
+export async function callRunLLMChat({ question, }) {
+    const client = await createRunLLMClient();
+    // Call the chat tool with the user's question
+    const result = await client.callTool({
+        name: "chat",
+        arguments: {
+            message: question,
+        },
+    });
+    // There's usually only one content item, but we'll handle multiple for safety
+    if (result.content && Array.isArray(result.content)) {
+        const textContent = result.content
+            .filter((item) => item.type === "text")
+            .map((item) => item.text)
+            .join("\n");
+        if (textContent) {
+            return textContent;
+        }
+    }
+    return "No response received from support";
+}
+export const initializeSupportTools = async ({ server, }) => {
+    server.tool("phoenix-support", PHOENIX_SUPPORT_DESCRIPTION, {
+        question: z
+            .string()
+            .describe("Your question about Arize Phoenix, OpenInference, or related topics"),
+    }, async ({ question }) => {
+        const result = await callRunLLMChat({ question });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: result,
+                },
+            ],
+        };
+    });
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arizeai/phoenix-mcp",
-  "version": "2.1.11",
+  "version": "2.2.0",
   "description": "A MCP server for Arize Phoenix",
   "bin": {
     "@arizeai/phoenix-mcp": "./build/index.js"
@@ -16,7 +16,7 @@
   "author": "oss@arize.com",
   "license": "Apache-2.0",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.0",
+    "@modelcontextprotocol/sdk": "^1.13.3",
     "glob": "^11.0.1",
     "minimist": "^1.2.8",
     "zod": "^3.24.2",