Opik Mcp Server (modelo Protocolo de Contexto)
Implementação do Protocolo de Contexto do Modelo (MCP) para Opik, permitindo integração perfeita com IDE e acesso unificado a prompts, projetos, rastros e métricas.
Visão geral
O que é Opik-MCP?
Opik-MCP é uma implementação do Modelo de Protocolo de Contexto (MCP) projetada para integração perfeita com Ambientes de Desenvolvimento Integrados (IDEs). Ele fornece um ponto de acesso unificado para gerenciar prompts, projetos, rastros e métricas, aprimorando o fluxo de trabalho para desenvolvedores e cientistas de dados. Esta ferramenta é particularmente útil para aqueles que desejam otimizar seus processos de aprendizado de máquina e melhorar a colaboração entre equipes.
Recursos do Opik-MCP
- Integração Sem Costura com IDE: Opik-MCP permite que os usuários integrem seu ambiente de desenvolvimento sem esforço, facilitando o gerenciamento de vários aspectos de projetos de aprendizado de máquina.
- Acesso Unificado: Os usuários podem acessar prompts, projetos, rastros e métricas a partir de uma única interface, reduzindo a complexidade de gerenciar várias ferramentas.
- Colaboração Aprimorada: O protocolo facilita uma melhor colaboração entre os membros da equipe, fornecendo uma plataforma compartilhada para gerenciamento de projetos.
- Código Aberto: Sendo um repositório público, o Opik-MCP está aberto a contribuições, permitindo que desenvolvedores aprimorem seus recursos e funcionalidades.
Como Usar o Opik-MCP
- Instalação: Comece clonando o repositório do Opik-MCP do GitHub. Use o comando:
git clone https://github.com/comet-ml/opik-mcp.git - Configuração: Siga as instruções de configuração fornecidas no arquivo README do repositório para configurar o ambiente de acordo com suas necessidades.
- Integração: Integre o Opik-MCP com seu IDE preferido. Instruções detalhadas podem ser encontradas na seção de documentação do repositório.
- Uso: Comece a usar os recursos do Opik-MCP para gerenciar seus projetos de aprendizado de máquina de forma eficaz. Acesse prompts, projetos, rastros e métricas através da interface unificada.
Perguntas Frequentes
Quais linguagens de programação o Opik-MCP suporta?
Opik-MCP foi projetado para ser agnóstico em relação a linguagens, permitindo seu uso com várias linguagens de programação comumente usadas em aprendizado de máquina, como Python, R e Java.
O Opik-MCP é gratuito para usar?
Sim, o Opik-MCP é um projeto de código aberto lançado sob a licença Apache-2.0, tornando-o gratuito para usar e modificar.
Como posso contribuir para o Opik-MCP?
Você pode contribuir fazendo um fork do repositório, fazendo suas alterações e enviando um pull request. Contribuições são bem-vindas, e você também pode relatar problemas ou sugerir recursos.
Onde posso encontrar mais informações sobre o Opik-MCP?
Para mais detalhes, visite a página oficial do Opik-MCP ou confira a documentação disponível no repositório do GitHub.
Detalhe
⚠️ Notice: SSE (Server-Sent Events) transport support is currently experimental and untested. For production use, we recommend using the direct process execution approach shown in the IDE integration examples.
🚀 What is Opik MCP Server?
Opik MCP Server is an open-source implementation of the Model Context Protocol for the Opik platform. It provides a unified interface for interacting with Opik's capabilities, supporting multiple transport mechanisms for flexible integration into various environments.
<br>You can use Opik MCP Server for:
-
IDE Integration:
- Seamlessly integrate with Cursor and other compatible IDEs
- Provide direct access to Opik's capabilities from your development environment
-
Unified API Access:
- Access all Opik features through a standardized protocol
- Leverage multiple transport options (stdio, SSE) for different integration scenarios
-
Platform Management:
- Manage prompts, projects, traces, and metrics through a consistent interface
- Organize and monitor your LLM applications efficiently
Features
- Prompts Management: Create, list, update, and delete prompts
- Projects/Workspaces Management: Organize and manage projects
- Traces: Track and analyze trace data
- Metrics: Gather and query metrics data
Quick Start
Installation
Manual Installation
### 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
Configuration
Create a .env file based on the example:
cp .env.example .env
### Edit .env with your specific configuration
Starting the Server
### Start with stdio transport (default)
npm run start:stdio
### Start with SSE transport for network access (experimental)
npm run start:sse
IDE Integration
Cursor Integration
To integrate with Cursor IDE, create a .cursor/mcp.json file in your project directory with the following configuration:
{
"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",
}
}
}
}
Replace /path/to/node with the path to your Node.js executable and /path/to/opik-mcp with the path to your opik-mcp installation. Also replace YOUR_API_KEY with your actual Opik API key.
Available Commands
The project includes a Makefile for common operations:
### 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
Transport Options
Standard Input/Output
Ideal for local integration where the client and server run on the same machine.
make start-stdio
Server-Sent Events (SSE)
Enables remote access and multiple simultaneous clients over HTTP. Note that this transport option is experimental.
make start-sse
For detailed information about the SSE transport, see docs/sse-transport.md.
Development
Testing
### Run all tests
npm test
### Run specific test suite
npm test -- tests/transports/sse-transport.test.ts
Pre-commit Hooks
This project uses pre-commit hooks to ensure code quality:
### Run pre-commit checks manually
make precommit
Documentation
- SSE Transport - Details on using the SSE transport
- API Reference - Complete API documentation
- Configuration - Advanced configuration options
- IDE Integration - Integration with Cursor IDE
Citation
If you use this project in your research, please cite it as follows:
Comet ML, Inc, Koc, V., & Boiko, Y. (2025). Opik MCP Server. Github. https://doi.org/10.5281/zenodo.15411156
Or use the following BibTeX entry:
@software{CometML_Opik_MCP_Server_2025,
author = {{Comet ML, Inc} and Koc, V. and Boiko, Y.},
title = {{Opik MCP Server}},
year = {2025},
publisher = {GitHub},
url = {https://doi.org/10.5281/zenodo.15411156},
doi = {10.5281/zenodo.15411156}
}
You can also find citation information in the CITATION.cff file in this repository.
License
Apache 2.0
Configuração do Servidor
{
"mcpServers": {
"opik-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--comet-ml--opik-mcp--opik-mcp",
"npm run start"
],
"env": {
"OPIK_API_BASE_URL": "opik-api-base-url",
"OPIK_API_KEY": "opik-api-key",
"OPIK_WORKSPACE_NAME": "opik-workspace-name"
}
}
}
}
