Metadata-Version: 2.4
Name: arize-tracing-assistant
Version: 0.1.1
Summary: Arize tracing assistant
Project-URL: Documentation, https://arize.com/docs/ax/observe/quickstart-llm
Author-email: Arize AI <support@arize.com>
Maintainer-email: Arize AI <support@arize.com>
License-Expression: BSD-2-Clause
License-File: LICENSE
Keywords: Explainability,Monitoring,Observability,Tracing
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Logging
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.10
Requires-Dist: mcp[cli]>=1.8.1
Requires-Dist: requests>=2.32.3
Description-Content-Type: text/markdown

# Arize Tracing Assistant

<a target="_blank" href="https://github.com/Arize-ai/arize/blob/main/sdk/python/arize-tracing-assistant/LICENSEE">
    <img src="https://img.shields.io/pypi/l/arize-otel">
</a>
<img src="https://badge.mcpx.dev?status=on" title="MCP Enabled"/>
<a href="https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/install-mcp?name=arize-tracing-assistant&config=eyJjb21tYW5kIjogInV2eCBhcml6ZS10cmFjaW5nLWFzc2lzdGFudEBsYXRlc3QifQ=="><img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Add Arize tracing assistant MCP server to Cursor" height=20 /></a>

An MCP server that provides with docs and support to instrument your AI application with Arize AX.

## Overview

This MCP server provides your LLM with docs and examples to instrument your AI apps with Arize AX. It also provides access to Arize support.
Connect it to your IDE or LLM and get curated tracing examples, setup guides and best practices!


## Installation

### Install uv

Make sure **uv** (the fast Python package manager) is installed on your system. Installation instructions: [uv installation guide](https://docs.astral.sh/uv/getting-started/installation/#standalone-installer).

- On macOS:
  ```bash
  brew install uv
  ```
- On Linux:
  ```bash
  curl -LsSf https://astral.sh/uv/install.sh | less
  ```
- On Windows:
  ```powershell
  powershell -c "irm https://astral.sh/uv/install.ps1 | more"
  ```

### IDE integration

#### Cursor

[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=arize-tracing-assistant&config=eyJjb21tYW5kIjogInV2eCBhcml6ZS10cmFjaW5nLWFzc2lzdGFudEBsYXRlc3QifQ==)

1. Go to Cursor Settings > MCP.
2. Click "Add new global MCP server" and add the server to your config JSON.
3. Remove the `env` section if you don't have access to RunLLM.

Example config:

```json
"arize-tracing-assistant": {
  "command": "uvx",
  "args": [
    "arize-tracing-assistant@latest"
  ]
}
```

---

#### Claude Desktop

1. Go to Claude Desktop Settings.
2. In Developer > Edit Config and add this to your config JSON:

```json
"arize-tracing-assistant": {
  "command": "/Users/myuser/miniconda3/bin/uvx",
  "args": [
   "arize-tracing-assistant@latest"
  ]
}
```

---

#### Manual MCP config

Add the following snippet to your MCP config file:

```json
  "mcpServers": {
    "arize-tracing-assistant": {
      "command": "uvx",
      "args": [
      "arize-tracing-assistant@latest"
    ]
    }
  }
```

## Usage

Once the MCP server is running, ask your IDE/LLM questions about tracing or general Arize support like...

- Instrument this app using Arize
- Can you use manual instrumentation so that I have more control over my traces?
- How can I redact sensitive information from my spans?
- Use decorators to have more control over the span attributes
- Can you make sure the context of this trace is propagated across these tool calls?
- Where can I find my Arize keys?

## Troubleshooting

- Make sure the JSON configs are perfectly formatted.
- Clear the **uv** cache with `uv cache clean` to force accessing the latest version.
- Make sure your `uv` command is pointing to the right location by running `which uv`, or simply use the full path.
- The server should start in the terminal just by running:

  ```bash
  uvx arize-tracing-assistant@latest
  ```

- Use the Anthropic MCP inspector by running:
  ```bash
  npx @modelcontextprotocol/inspector uvx arize-tracing-assistant@latest
  ```
