@arizeai/phoenix-mcp 2.1.7 → 2.1.9

package/README.md

@@ -19,6 +19,7 @@ Phoenix MCP Server is an implementation of the Model Context Protocol for the Ar
 
 You can use Phoenix MCP Server for:
 
+- **Projects Management**: List and explore projects that organize your observability data
 - **Prompts Management**: Create, list, update, and iterate on prompts
 - **Datasets**: Explore datasets, and syntesize new examples
 - **Experiments**: Pull experiment results and visualize them with the help of an LLM

package/build/index.js

@@ -7,16 +7,20 @@ import minimist from "minimist";
 import { initializeDatasetTools } from "./datasetTools.js";
 import { initializeExperimentTools } from "./experimentTools.js";
 import { initializePromptTools } from "./promptTools.js";
+import { initializeProjectTools } from "./projectTools.js";
 import { initializeReadmeResources } from "./readmeResource.js";
 const argv = minimist(process.argv.slice(2));
+const headers = argv.apiKey
+    ? {
+        Authorization: `Bearer ${argv.apiKey}`,
+        api_key: argv.apiKey, // For hosted phoenix
+    }
+    : {};
 // Initialize Phoenix client
 const client = createClient({
     options: {
         baseUrl: argv.baseUrl || "http://localhost:6006",
-        headers: {
-            Authorization: `Bearer ${argv.apiKey}`,
-            api_key: argv.apiKey, // For hosted phoenix
-        },
+        headers,
     },
 });
 // Create server instance
@@ -31,6 +35,7 @@ const server = new McpServer({
 initializePromptTools({ client, server });
 initializeExperimentTools({ client, server });
 initializeDatasetTools({ client, server });
+initializeProjectTools({ client, server });
 async function main() {
     // Initialize readme resources first
     if (process.env.DANGEROUSLY_READ_README_FILES === "true") {

package/build/projectTools.js

@@ -0,0 +1,48 @@
+import z from "zod";
+const LIST_PROJECTS_DESCRIPTION = `Get a list of all projects.
+
+Projects are containers for organizing traces, spans, and other observability data. 
+Each project has a unique name and can contain traces from different applications or experiments.
+
+Example usage:
+  Show me all available projects
+
+Expected return:
+  Array of project objects with metadata.
+  Example: [
+    {
+      "id": "UHJvamVjdDox",
+      "name": "default",
+      "description": "Default project for traces"
+    },
+    {
+      "id": "UHJvamVjdDoy", 
+      "name": "my-experiment",
+      "description": "Project for my ML experiment"
+    }
+  ]`;
+export const initializeProjectTools = ({ client, server, }) => {
+    server.tool("list-projects", LIST_PROJECTS_DESCRIPTION, {
+        limit: z.number().min(1).max(100).default(100).optional(),
+        cursor: z.string().optional(),
+        includeExperimentProjects: z.boolean().default(false).optional(),
+    }, async ({ limit = 100, cursor, includeExperimentProjects = false }) => {
+        const response = await client.GET("/v1/projects", {
+            params: {
+                query: {
+                    limit,
+                    cursor,
+                    include_experiment_projects: includeExperimentProjects,
+                },
+            },
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(response.data?.data, null, 2),
+                },
+            ],
+        };
+    });
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arizeai/phoenix-mcp",
-  "version": "2.1.7",
+  "version": "2.1.9",
   "description": "A MCP server for Arize Phoenix",
   "bin": {
     "@arizeai/phoenix-mcp": "./build/index.js"
@@ -16,11 +16,11 @@
   "author": "oss@arize.com",
   "license": "Apache-2.0",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.8.0",
+    "@modelcontextprotocol/sdk": "^1.12.0",
     "glob": "^11.0.1",
     "minimist": "^1.2.8",
     "zod": "^3.24.2",
-    "@arizeai/phoenix-client": "2.0.1"
+    "@arizeai/phoenix-client": "2.1.0"
   },
   "devDependencies": {
     "@types/glob": "^8.1.0",