@arizeai/phoenix-mcp 2.1.7 → 2.1.8

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,6 +7,7 @@ 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));
 // Initialize Phoenix client
@@ -31,6 +32,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.8",
   "description": "A MCP server for Arize Phoenix",
   "bin": {
     "@arizeai/phoenix-mcp": "./build/index.js"