@arizeai/phoenix-mcp

Instructions

Implementation Reference

• js/packages/phoenix-mcp/src/supportTools.ts:90-100 (handler)

  Handler for the 'phoenix-support' tool. It calls the 'callRunLLMQuery' helper with the user query and returns the result formatted as MCP text content.

  async ({ query }) => {
    const result = await callRunLLMQuery({ query });
    return {
      content: [
        {
          type: "text",
          text: result,
        },
      ],
    };
  }

• js/packages/phoenix-mcp/src/supportTools.ts:83-89 (schema)

  Input schema for the 'phoenix-support' tool using Zod: a string 'query' with description.

  {
    query: z
      .string()
      .describe(
        "Your question about Arize Phoenix, OpenInference, or related topics"
      ),
  },

• js/packages/phoenix-mcp/src/supportTools.ts:81-101 (registration)

  Registration of the 'phoenix-support' tool on the MCP server within the initializeSupportTools function, including name, description reference, input schema, and inline handler.

    "phoenix-support",
    PHOENIX_SUPPORT_DESCRIPTION,
    {
      query: z
        .string()
        .describe(
          "Your question about Arize Phoenix, OpenInference, or related topics"
        ),
    },
    async ({ query }) => {
      const result = await callRunLLMQuery({ query });
      return {
        content: [
          {
            type: "text",
            text: result,
          },
        ],
      };
    }
  );

• js/packages/phoenix-mcp/src/supportTools.ts:45-73 (helper)

  Core helper function used by the phoenix-support handler. Creates an MCP client to RunLLM server and calls their 'search' tool with the query, extracts and returns text response.

  export async function callRunLLMQuery({
    query,
  }: {
    query: string;
  }): Promise<string> {
    const client = await createRunLLMClient();
  
    // Call the chat tool with the user's question
    const result = await client.callTool({
      name: "search",
      arguments: {
        query: query,
      },
    });
  
    // There's usually only one content item, but we'll handle multiple for safety
    if (result.content && Array.isArray(result.content)) {
      const textContent = result.content
        .filter((item) => item.type === "text")
        .map((item) => item.text)
        .join("\n");
  
      if (textContent) {
        return textContent;
      }
    }
  
    return "No response received from support";
  }

• js/packages/phoenix-mcp/src/index.ts:45-45 (registration)

  Invocation of initializeSupportTools in the main server setup, which registers the phoenix-support tool among others.

  initializeSupportTools({ server });