Skip to main content
Glama
Opik MCP Server

Opik MCP Server

by comet-ml

ライセンス Node.js バージョン タイプスクリプト

⚠️ 注意: SSE(Server-Sent Events)トランスポートのサポートは現在試験段階であり、テストされていません。本番環境では、IDE統合例に示されている直接プロセス実行アプローチの使用をお勧めします。

🚀 Opik MCP サーバーとは何ですか?

Opik MCPサーバーは、Opikプラットフォーム向けのモデルコンテキストプロトコル(Model Context Protocol)のオープンソース実装です。Opikの機能と連携するための統一インターフェースを提供し、複数のトランスポートメカニズムをサポートすることで、様々な環境への柔軟な統合を実現します。

Opik MCP サーバーは次の用途に使用できます。

  • IDE統合:

    • Cursor やその他の互換性のある IDE とシームレスに統合

    • 開発環境から Opik の機能に直接アクセスできるようにします

  • 統合 API アクセス:

    • 標準化されたプロトコルを通じて Opik のすべての機能にアクセスします

    • さまざまな統合シナリオに合わせて複数のトランスポート オプション (stdio、SSE) を活用

  • プラットフォーム管理:

    • 一貫したインターフェースを通じてプロンプト、プロジェクト、トレース、メトリックを管理します

    • LLM アプリケーションを効率的に整理および監視します

Related MCP server: dap-mcp

特徴

  • プロンプト管理: プロンプトの作成、一覧表示、更新、削除

  • プロジェクト/ワークスペース管理: プロジェクトの整理と管理

  • トレース: トレースデータを追跡および分析する

  • メトリクス: メトリクスデータを収集してクエリする

クイックスタート

インストール

手動インストール

# Clone the repository
git clone https://github.com/comet-ml/opik-mcp.git
cd opik-mcp

# Install dependencies and build
npm install
npm run build

構成

例に基づいて.envファイルを作成します。

cp .env.example .env
# Edit .env with your specific configuration

サーバーの起動

# Start with stdio transport (default)
npm run start:stdio

# Start with SSE transport for network access (experimental)
npm run start:sse

IDE統合

カーソル統合

Cursor IDE と統合するには、次の構成でプロジェクト ディレクトリに.cursor/mcp.jsonファイルを作成します。

{
  "mcpServers": {
    "opik": {
      "command": "/path/to/node",
      "args": [
        "/path/to/opik-mcp/build/index.js",
        "--apiUrl",
        "https://www.comet.com/opik/api",
        "--apiKey",
        "YOUR_API_KEY",
        "--workspace",
        "default",
        "--debug",
        "true"
      ],
      "env": {
        "OPIK_API_BASE_URL": "https://www.comet.com/opik/api",
        "OPIK_API_KEY": "YOUR_API_KEY",
        "OPIK_WORKSPACE_NAME": "default",
      }
    }
  }
}

/path/to/node Node.js実行ファイルへのパスに、 /path/to/opik-mcp opik-mcpインストールへのパスに置き換えてください。また、 YOUR_API_KEY実際のOpik APIキーに置き換えてください。

利用可能なコマンド

プロジェクトには、一般的な操作用の Makefile が含まれています。

# Display all available commands
make help

# Run tests
make test

# Run transport-specific tests
make test-transport

# Start the server with SSE transport (experimental)
make start-sse

# Start the server with stdio transport
make start-stdio

交通手段

標準入出力

クライアントとサーバーが同じマシン上で実行されるローカル統合に最適です。

make start-stdio

サーバー送信イベント (SSE)

HTTP経由のリモートアクセスと複数の同時クライアントを可能にします。このトランスポートオプションは試験段階です。

make start-sse

SSE トランスポートの詳細については、 docs/sse-transport.mdを参照してください。

発達

テスト

# Run all tests
npm test

# Run specific test suite
npm test -- tests/transports/sse-transport.test.ts

コミット前フック

このプロジェクトでは、コードの品質を確保するために事前コミットフックを使用しています。

# Run pre-commit checks manually
make precommit

ドキュメント

ライセンス

アパッチ 2.0

Available Tools

19 tools
create-projectCInspect

Create a new project/workspace

Inputs: name (required), description, workspaceName.

create-promptCInspect

Create a new prompt

Inputs: name (required).

create-prompt-versionCInspect

Create a new version of a prompt

Inputs: commit_message (required), name (required), template (required).

delete-projectCInspect

Delete a project

Inputs: projectId (required), workspaceName.

delete-promptCInspect

Delete a prompt

Inputs: promptId (required).

get-metricsCInspect

Get metrics data

Inputs: endDate, metricName, projectId, projectName, +1 more.

get-opik-examplesCInspect

Get examples of how to use Opik Comet's API for specific tasks

Inputs: task (required).

get-opik-helpBInspect

Get contextual help about Opik Comet's capabilities

Inputs: topic (required), subtopic.

get-opik-tracing-infoCInspect

Get information about Opik's tracing capabilities and how to use them

Inputs: topic.

get-project-by-idCInspect

Get a single project by ID

Inputs: projectId (required), workspaceName.

get-prompt-by-idCInspect

Get a single prompt by ID

Inputs: promptId (required).

get-server-infoBInspect

Get information about the Opik server configuration

Inputs: random_string.

get-trace-by-idCInspect

Get a single trace by ID

Inputs: traceId (required), workspaceName.

get-trace-statsCInspect

Get statistics for traces

Inputs: endDate, projectId, projectName, startDate, +1 more.

list-projectsCInspect

Get a list of projects/workspaces

Inputs: page (required), size (required), sortBy, sortOrder, +1 more.

list-promptsCInspect

Get a list of Opik prompts

Inputs: page (required), size (required).

list-tracesCInspect

Get a list of traces

Inputs: page (required), size (required), projectId, projectName, +1 more.

update-projectCInspect

Update a project

Inputs: projectId (required), description, name, workspaceName.

update-promptCInspect

Update a prompt

Inputs: name (required), promptId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 19 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting specific resources (projects, prompts, traces, metrics, help) and actions (create, get, list, update, delete). There is no overlap or ambiguity between tools, making it easy for an agent to select the right one for any operation.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with hyphens (e.g., create-project, get-project-by-id, list-projects). The naming is uniform across all 19 tools, using clear verbs like create, get, list, update, and delete paired with specific nouns.

    Tool Count4/5

    With 19 tools, the count is slightly high but reasonable for a comprehensive server covering projects, prompts, traces, metrics, and help. It feels well-scoped for the Opik domain, though it borders on being heavy compared to typical 3-15 tool ranges.

    Completeness5/5

    The tool set provides complete CRUD/lifecycle coverage for projects and prompts (create, get, list, update, delete), with additional tools for traces, metrics, and help. There are no obvious gaps; agents can perform all core operations without dead ends in this domain.

    Maintenance

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      D
      maintenance
      Implements the Model Context Protocol (MCP) to provide AI models with a standardized interface for connecting to external data sources and tools like file systems, databases, or APIs.
      1
      153
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      An implementation of the Model Context Protocol (MCP) that enables interaction with debug adapters, allowing language models to control debuggers, set breakpoints, evaluate expressions, and navigate source code during debugging sessions.
      41
      AGPL 3.0
    • F
      license
      Not graded
      quality
      D
      maintenance
      A Python-based implementation of the Model Context Protocol that enables communication between a model context management server and client through a request-response architecture.
      -
    • -
      license
      Not graded
      quality
      D
      maintenance
      A standardized foundation for building Model Context Protocol servers that integrate with VS Code, using Python with stdio transport for seamless AI tool integration.
      -