Skip to main content

phoenix/js/packages/phoenix-mcp at main · Arize-ai/phoenix

Github
 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. You can use Phoenix MCP Server for:
  • 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 see a use-case covered? @arizeai/phoenix-mcp is open-source! Issues and PRs welcome.

​
Installation

npm i @arizeai/phoenix-mcp
This MCP server can be used using npx and can be directly integrated with clients like Claude Desktop, Cursor, and more. 
{
  "mcpServers": {
    "phoenix": {
      "command": "npx",
      "args": [
        "-y",
        "@arizeai/phoenix-mcp@latest",
        "--baseUrl",
        "https://my-phoenix.com",
        "--apiKey",
        "your-api-key"
      ]
    }
  }
}

​
Development

​
Install

This package is managed via a pnpm workspace. 
// From the /js/ directory
pnpm install
pnpm build
This only needs to be repeated if dependencies change or there is a change to the phoenix-client.

​
Building

To build the project: 
pnpm build

​
Development Mode

To run in development mode: 
pnpm dev

​
Debugging

You can build and run the MCP inspector using the following: 
pnpm inspect

​
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
Make sure to set these in a .env file. See .env.example.

​
License

Apache 2.0