pod
Other formats agents might prefer:
markdownjsonllms.txt

Agent? You probably want markdown or json, or Pod over MCP.

Reported issues for Opik MCP Server

Pod holds 24 of 29 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to Opik MCP Server.

Most discussed

[Feature Request] Create Installation Wizard Script

Description

Create interactive installation wizard scripts for Unix and Windows to simplify initial setup.

Scripts to Create

  • scripts/install.sh (Unix/macOS/Linux)
  • scripts/install.ps1 (Windows PowerShell)

Features

  • Interactive API key input with validation
  • Workspace selection
  • Transport preference
  • IDE auto-detection and configuration

Tasks

  • Create scripts/install.sh with interactive prompts
  • Create scripts/install.ps1 for Windows
  • Add API key validation
  • [

Read the thread · 2025-10-01 · closed · outside contributor · 1 comment

[Feature Request] Add Docker Support

Description

Add Docker support for easy deployment, testing, and cross-platform compatibility.

Deliverables

  1. Dockerfile (multi-stage build)
  2. docker-compose.yml
  3. Docker Hub image
  4. Documentation

Tasks

  • Create Dockerfile with multi-stage build (<100MB target)
  • Create docker-compose.yml with environment examples
  • Set up Docker Hub publishing workflow
  • Add multi-platform support (linux/amd64, linux/arm64)
  • Create docs/integrations/docker.md
  • Add Docker

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Feature Request] Add One-Click Install Support

Description

Add one-click install buttons and deep links for popular IDEs to simplify the installation process.

IDEs to Support

  • VS Code
  • VS Code Insiders
  • Cursor
  • Windsurf
  • Claude Desktop

Implementation

Create install links and buttons that automatically configure the MCP server in supported IDEs.

Tasks

  • Research deep link protocols for each IDE
  • Create install buttons with shields.io badges
  • Add installation links to README
  • Test installation flow in eac

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Improvement] Implement Granular Toolset Configuration

Description

Enhance the existing toolset configuration with more granular control over individual tools and experimental features.

Current State

  • Basic toolset selection exists (prompts, projects, traces, metrics)
  • All-or-nothing approach for each toolset

Proposed Enhancements

  1. --disable-tools flag for excluding specific tools
  2. --enable-experimental flag for opt-in experimental features
  3. Document tool categories (read/write/admin)
  4. Tool-level permissions

Example Usag

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Feature Request] Add Read-Only Mode (Security)

Description

Add read-only mode to prevent mutation operations, providing a safer option for production deployments and untrusted environments.

Use Cases

  • Production monitoring without risk of data modification
  • Shared access for read-only users
  • Development environments with production data
  • Security-conscious deployments

Implementation

  • Add --read-only CLI flag
  • Add OPIK_READ_ONLY=true environment variable
  • Block all create/update/delete operations
  • Return clear error mes

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Feature Request] Add Streamable HTTP Transport (Modern Alternative)

Description

Add Streamable HTTP transport as the modern, recommended alternative to SSE for network-based MCP server access.

Benefits

  • Modern alternative to SSE
  • Better performance and reliability
  • Official SDK support
  • Recommended by MCP specification

Implementation

Use SDK's StreamableHTTPServerTransport from @modelcontextprotocol/sdk/server/streamableHttp.js

Tasks

  • Implement StreamableHTTPServerTransport
  • Add --transport streamable-http CLI option
  • Conf

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Enhancement] Replace Custom SSE Transport with Official SDK Implementation

Description

Replace the custom SSE transport implementation with the official SDK version for better maintainability and feature support.

Current State

  • Custom src/transports/sse-transport.ts (experimental, untested)
  • Express-based custom implementation
  • Limited features and error handling
  • Marked as experimental in README

Target State

  • Use @modelcontextprotocol/sdk/server/sse.js
  • Official SDK support and maintenance
  • Built-in features (auth, error handling, rate limiting)

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Enhancement] Upgrade to @modelcontextprotocol/sdk v1.18.2

Description

Upgrade from SDK v1.6.1 to v1.18.2 to access latest features, bug fixes, and official transport implementations.

Current State

  • SDK version: 1.6.1
  • Missing features: Official transports, auth module, rate limiting, latest bug fixes

Target State

  • SDK version: 1.18.2
  • Access to all official transports (stdio, SSE, streamableHttp)
  • Built-in auth and rate limiting support
  • Latest protocol improvements

Tasks

  • Update package.json dependency to v1.18.2
  • Review

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

Most recent

Add list-spans and get-span-by-id tools

Summary

The MCP server exposes tools for projects, traces, and stats, but has no tools for reading span-level data. This forces users to fall back to raw REST API calls (/api/v1/private/spans) for the most common debugging workflow: inspecting individual LLM calls, tool invocations, per-span timing, and token usage within a trace.

(Transferred from comet-ml/opik#6077)

Current state

The MCP server provides:

  • list-projects
  • list-traces / get-trace-by-id
  • get-trace-stats

Read the thread · 2026-04-04 · open · external user · 0 comments

429 in streamable-http-transport.ts doesn't inspect Retry-After — incorrect retry behavior

Summary

Finding

Ran pitstop-check against the MCP transport layer:

src/transports/streamable-http-transport.ts:153 — 429 handled without Retry-After

Why it matters

In MCP transport, a 429 can mean different things:

  • Transient pressure → wait and retry
  • Quota exhaustion → do not retry

When Retry-After is ignored, the transport retries quota exhaustion cases that can't recover until the window resets.

Example

curl -s -X POST https://web-production-273d3.up.railway

[Read the thread](https://github.com/comet-ml/opik-mcp/issues/96) · 2026-04-02 · open · external user · 0 comments

### [Feature Request] Create Homebrew Formula

## Description
Create Homebrew formula for easy macOS installation.

## Implementation
Create a Homebrew tap: `comet-ml/homebrew-opik`

## Installation Experience
```bash
# Add tap
brew tap comet-ml/opik

# Install
brew install opik-mcp

# Use
opik-mcp --apiKey YOUR_KEY

Tasks

  • Create comet-ml/homebrew-opik repository
  • Write Formula/opik-mcp.rb
  • Test installation on macOS (Intel)
  • Test installation on macOS (Apple Silicon)
  • Add to README as installation method
  • [

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Feature Request] Add Rate Limiting

Description

Implement rate limiting using SDK's built-in express-rate-limit support.

Features

  • Per-client rate limits
  • Per-endpoint rate limits
  • Configurable limits via CLI/env
  • Rate limit headers in responses
  • Custom error messages

Implementation

The SDK already includes express-rate-limit in dependencies (v1.18.2).

import rateLimit from 'express-rate-limit';

const limiter = rateLimit({
  windowMs: 15 * 60 * 1000, // 15 minutes
  max: 100, // Limit each IP to 100

[Read the thread](https://github.com/comet-ml/opik-mcp/issues/39) · 2025-10-01 · closed · outside contributor · 0 comments

### [Feature Request] Implement Caching Layer

## Description
Add caching layer for frequently accessed data to improve performance and reduce API calls.

## Data to Cache
- Project list
- Workspace information
- Prompt templates
- Trace statistics
- API responses (configurable)

## Implementation Options
1. **node-cache** (in-memory, simple)
2. **Redis** (external, scalable)
3. **lru-cache** (memory-efficient)

## Tasks
- [ ] Choose caching solution (node-cache recommended for simplicity)
- [ ] Implement cache layer utility
- [ ] Add cachin

[Read the thread](https://github.com/comet-ml/opik-mcp/issues/38) · 2025-10-01 · closed · outside contributor · 0 comments

### [Feature Request] Add OpenTelemetry Support

## Description
Instrument the server with OpenTelemetry for comprehensive observability.

## Metrics to Track
- Request duration
- Tool execution time
- Error rates
- API call latency
- Transport performance
- Resource usage

## Export to Opik (Dogfooding!)
Export traces back to Opik itself for self-monitoring.

## Implementation
```typescript
import { NodeSDK } from '@opentelemetry/sdk-node';
import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';

const sdk = n

[Read the thread](https://github.com/comet-ml/opik-mcp/issues/37) · 2025-10-01 · closed · outside contributor · 0 comments

### [Feature Request] Add Health Check Endpoint

## Description
Add comprehensive health check endpoints for monitoring and load balancing.

## Endpoints to Add
1. **/health** - Basic health check (existing, enhance)
2. **/health/ready** - Readiness probe
3. **/health/live** - Liveness probe

## Health Checks
Each endpoint should check:
- API connectivity to Opik
- Authentication status
- Resource availability
- Transport status

## Implementation
```typescript
app.get('/health', (req, res) => {
  res.json({ status: 'ok', timestamp: Date.now()

[Read the thread](https://github.com/comet-ml/opik-mcp/issues/36) · 2025-10-01 · closed · outside contributor · 0 comments

### [Improvement] Add Structured Logging

## Description
Replace file-based logging with structured logging for better observability.

## Current State
- File-based logging to /tmp/opik-mcp.log
- Simple text format
- Limited metadata

## Target State
- Structured JSON logging
- Multiple log levels
- Rich metadata
- Log rotation
- Multiple outputs

## Implementation Options
1. **pino** (recommended - fast, low overhead)
2. **winston** (feature-rich)

## Tasks
- [ ] Choose logging library (pino recommended)
- [ ] Replace all logToFile() c

[Read the thread](https://github.com/comet-ml/opik-mcp/issues/35) · 2025-10-01 · closed · outside contributor · 0 comments

### [Feature Request] Implement Prompts as MCP Prompts

## Description
Use MCP's native prompt system instead of exposing prompts as tools.

## Current State
- Prompts are exposed as tools (get-prompts, create-prompt, etc.)
- Not using MCP's native prompt capabilities

## Target State
- Use `server.setRequestHandler(ListPromptsRequestSchema, ...)`
- Use `server.setRequestHandler(GetPromptRequestSchema, ...)`
- Native MCP prompt protocol

## Benefits
- Better integration with MCP clients
- Follow MCP specification more closely
- Cleaner separation of 

[Read the thread](https://github.com/comet-ml/opik-mcp/issues/34) · 2025-10-01 · closed · outside contributor · 0 comments

### [Feature Request] Add Resource Subscriptions and Pagination

## Description
Implement resource subscriptions for real-time updates and proper cursor-based pagination.

## Part 1: Resource Subscriptions
Allow clients to subscribe to resource changes for real-time updates.

### Features
- Real-time updates via Server-Sent Events
- Subscribe to project changes
- Subscribe to trace updates
- Subscribe to prompt changes

### Implementation
```typescript
server.resource('opik://projects-list', {
  subscribe: true,
  handler: async () => { ... }
});

Part

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Feature Request] Add Developer Documentation

Description

Create comprehensive developer documentation for contributors.

Files to Create

  1. CONTRIBUTING.md - Contribution guidelines
  2. ARCHITECTURE.md - Technical architecture deep-dive
  3. docs/api-reference.md - Expand current API docs
  4. docs/troubleshooting.md - Common issues and solutions
  5. docs/migration-guide.md - Version upgrade guides

CONTRIBUTING.md Should Include

  • Code of conduct
  • Development setup
  • Coding standards
  • Pull request process
  • Testin

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Feature Request] Create Integration Guides

Description

Create comprehensive integration guides for all supported IDEs and platforms.

Guides to Create

  1. docs/integrations/cursor.md
  2. docs/integrations/vscode.md
  3. docs/integrations/windsurf.md
  4. docs/integrations/claude-desktop.md
  5. docs/integrations/docker.md
  6. docs/integrations/kubernetes.md

Each Guide Should Include

  • Prerequisites
  • Step-by-step installation
  • Configuration examples
  • Screenshots
  • Troubleshooting
  • Advanced usage

Tasks

  • Create docs/integratio

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Feature Request] Generate API Documentation

Description

Add comprehensive API documentation using TypeDoc and publish to GitHub Pages.

Implementation

  • Install and configure TypeDoc
  • Generate API reference from TypeScript source
  • Publish to GitHub Pages
  • Add to CI/CD pipeline

Tasks

  • Add typedoc as dev dependency
  • Configure typedoc.json
  • Add npm script: docs:generate
  • Set up GitHub Pages deployment
  • Add docs generation to CI
  • Add documentation badge to README
  • Link from main README

Scr

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Enhancement] Migrate from npm to pnpm

Description

Migrate package manager from npm to pnpm for better performance and consistency with MCP ecosystem.

Benefits

  • Faster installations
  • Better disk space efficiency
  • Stricter dependency resolution
  • Built-in monorepo support (future-proofing)
  • Industry standard for MCP servers

Tasks

  • Add pnpm-workspace.yaml (for future monorepo support)
  • Convert package-lock.json to pnpm-lock.yaml
  • Update all workflows to use pnpm
    • .github/workflows/ci.yml
    • .gi

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Enhancement] Upgrade ESLint Configuration

Description

Upgrade to ESLint 9+ with stricter rules and modern flat config.

Changes

  • Migrate to ESLint 9+ flat config format
  • Add @typescript-eslint/strict rules
  • Add @typescript-eslint/stylistic rules
  • Add eslint-plugin-security

Tasks

  • Upgrade ESLint to v9+
  • Create eslint.config.js (flat config)
  • Add strict TypeScript rules
  • Add stylistic TypeScript rules
  • Add eslint-plugin-security
  • Fix all new linting errors
  • Update CI workflow
  • Update d

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Enhancement] Add End-to-End Tests

Description

Create end-to-end test suite for full integration testing.

Test Scenarios

  1. Full server startup (stdio transport)
  2. Full server startup (http transport)
  3. Complete tool execution flow
  4. Authentication flow
  5. Multi-client scenarios
  6. Error recovery

Tasks

  • Create tests/e2e/ directory structure
  • Write server startup tests
  • Write tool execution E2E tests
  • Write authentication E2E tests
  • Write multi-client tests
  • Add to CI workflow
  • Docu

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

The remaining reports are on the project's issue tracker.