@arizeai/phoenix-mcp 2.0.0 → 2.1.1

package/LICENSE

@@ -188,7 +188,7 @@ Copyright (c) Arize AI, Inc
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2024 Comet ML, Inc
+   Copyright 2025 Arize AI, Inc
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -1,22 +1,70 @@
-# Phoenix MCP Server
+<h1 align="center" style="border-bottom: none">
+    <div>
+        <a href="https://phoenix.arize.com/?utm_medium=github&utm_content=header_img&utm_campaign=phoenix-mcp">
+            <picture>
+                <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Arize-ai/phoenix-assets/refs/heads/main/logos/Phoenix/phoenix.svg">
+                <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/Arize-ai/phoenix-assets/refs/heads/main/logos/Phoenix/phoenix-white.svg">
+                <img alt="Arize Phoenix logo" src="https://raw.githubusercontent.com/Arize-ai/phoenix-assets/refs/heads/main/logos/Phoenix/phoenix.svg" width="100" />
+            </picture>
+        </a>
+        <br>
+        Arize Phoenix MCP Server
+    </div>
+</h1>
 
-A MCP server for Arize Phoenix.
+[![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"/>
 
-## Installation
+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.
 
-This package is installed using PNPM:
+You can use Phoenix MCP Server for:
 
-```bash
-pnpm install @arize/phoenix-mcp
+- **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
+
+Don't se a use-case covered? `@arizeai/phoenix-mcp` is [open-source](https://github.com/Arize-ai/phoenix)! Issues and PRs welcome.
+
+## Installation
+
+This MCP server can be used using `npx` and can be directly integrated with clients like Claude Desktop, Cursor, and more.
+
+```json
+{
+  "mcpServers": {
+    "phoenix": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@arizeai/phoenix-mcp@latest",
+        "--baseUrl",
+        "https://my-phoenix.com",
+        "--apiKey",
+        "your-api-key"
+      ]
+    }
+  }
 ```
 
 ## Development
 
+## Install
+
+This package as managed via a pnpm workspace.
+
+```sh
+// From the /js/ directory
+pnpm install -r
+pnpm build -r
+```
+
+This only needs to be repeated if dependancies change or there is a change to the phoenix-client.
+
 ### Building
 
 To build the project:
 
-```bash
+```sh
 pnpm build
 ```
 
@@ -30,19 +78,21 @@ pnpm dev
 
 ### Debugging
 
-To run the debugger:
+You can build and run the MCP inspector using the following:
 
 ```bash
-npx @modelcontextprotocol/inspector node ./build/index.js
+pnpm inspect
 ```
 
 ## Environment Variables
 
-The server requires the following environment variables:
+When developing, the server requires the following environment variables:
 
 - `PHOENIX_API_KEY`: Your Phoenix API key
 - `PHOENIX_BASE_URL`: The base URL for Phoenix
 
-## License
+Make sure to set these in a `.env` file. See `.env.example`.
+
+# License
 
-This project is licensed under the Elv2 license.
+Apache 2.0

package/build/index.js

@@ -1,10 +1,13 @@
+#!/usr/bin/env node
 /* eslint-disable no-console */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { createClient } from "@arizeai/phoenix-client";
 import minimist from "minimist";
-import { initializeDatasetTools, initializeExperimentTools, initializePromptTools, } from "./tools/index.js";
-import { initializeReadmeResources } from "./resources/index.js";
+import { initializeDatasetTools } from "./datasetTools.js";
+import { initializeExperimentTools } from "./experimentTools.js";
+import { initializePromptTools } from "./promptTools.js";
+import { initializeReadmeResources } from "./readmeResource.js";
 const argv = minimist(process.argv.slice(2));
 // Initialize Phoenix client
 const client = createClient({

package/build/{resources/readme.js → readmeResource.js}

@@ -14,7 +14,7 @@ const _dirname = typeof __dirname !== "undefined"
  */
 export async function initializeReadmeResources({ server, }) {
     // Start from the directory where this file is located
-    const baseDir = path.dirname(path.resolve(_dirname, "../../../.."));
+    const baseDir = path.dirname(path.resolve(_dirname, "../../.."));
     // TODO: Refactor to fetch from public github repo instead of filesystem
     // Find all README files recursively (case insensitive)
     const readmeFiles = await glob("**/README*", {

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@arizeai/phoenix-mcp",
-  "version": "2.0.0",
+  "version": "2.1.1",
   "description": "A MCP server for Arize Phoenix",
   "bin": {
-    "phoenix-mcp-server": "./build/index.js"
+    "@arizeai/phoenix-mcp": "./build/index.js"
   },
   "type": "module",
   "files": [

package/build/resources/index.js

@@ -1 +0,0 @@
-export * from "./readme.js";

package/build/tools/index.js

@@ -1,3 +0,0 @@
-export * from "./promptTools.js";
-export * from "./experimentTools.js";
-export * from "./datasetTools.js";