{"id":26362288,"url":"https://github.com/comet-ml/opik-mcp","last_synced_at":"2025-04-10T20:44:22.710Z","repository":{"id":281887266,"uuid":"946763772","full_name":"comet-ml/opik-mcp","owner":"comet-ml","description":"Model Context Protocol (MCP) implementation for Opik enabling seamless IDE integration and unified access to prompts, projects, traces, and metrics. ","archived":false,"fork":false,"pushed_at":"2025-03-25T10:20:45.000Z","size":303,"stargazers_count":19,"open_issues_count":2,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-02T12:51:00.900Z","etag":null,"topics":["generative-ai","mcp-server","modelcontextprotocol","typescript"],"latest_commit_sha":null,"homepage":"https://www.comet.com/opik/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/comet-ml.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-11T16:31:03.000Z","updated_at":"2025-04-02T01:45:15.000Z","dependencies_parsed_at":"2025-03-11T17:47:17.980Z","dependency_job_id":"7d9e8ad9-de18-468b-92a4-1848b2148961","html_url":"https://github.com/comet-ml/opik-mcp","commit_stats":null,"previous_names":["comet-ml/opik-mcp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/comet-ml%2Fopik-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/comet-ml%2Fopik-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/comet-ml%2Fopik-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/comet-ml%2Fopik-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/comet-ml","download_url":"https://codeload.github.com/comet-ml/opik-mcp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248294430,"owners_count":21079876,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["generative-ai","mcp-server","modelcontextprotocol","typescript"],"created_at":"2025-03-16T18:01:32.163Z","updated_at":"2025-04-10T20:44:22.704Z","avatar_url":"https://github.com/comet-ml.png","language":"TypeScript","funding_links":[],"categories":["Monitoring \u0026 Observability","Monitoring","MCP 服务器精选列表","💻 \u003ca name=\"development-tools\"\u003e\u003c/a\u003eDevelopment Tools","📚 Projects (1974 total)","Production-Ready Servers","پیاده‌سازی‌های سرور","📦 Other","Legend","官方 MCP 服务器列表","MCP Servers","Community Servers","Uncategorized","カテゴリ","Cloud Services","📊 Monitoring \u0026 Observability","Table of Contents","Developer Tools","Data \u0026 Analytics","TypeScript"],"sub_categories":["Video","📊 数据分析、处理与可视化","MCP Servers","💻 \u003ca name=\"developer-tools\"\u003e\u003c/a\u003eابزارهای توسعه‌دهنده","💻 \u003ca name=\"developer-tools\"\u003e\u003c/a\u003eDeveloper Tools","💻 Developer Tools","How to Submit","Uncategorized","🛠️ \u003ca name=\"developer-tools\"\u003e\u003c/a\u003e開発ツール","Developer Tools"],"readme":"\u003ch1 align=\"center\" style=\"border-bottom: none\"\u003e\n    \u003cdiv\u003e\n        \u003ca href=\"https://www.comet.com/site/products/opik/?from=llm\u0026utm_source=opik\u0026utm_medium=github\u0026utm_content=header_img\u0026utm_campaign=opik-mcp\"\u003e\n            \u003cpicture\u003e\n                \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"docs/assets/logo-dark-mode.svg\"\u003e\n                \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"docs/assets/logo-light-mode.svg\"\u003e\n                \u003cimg alt=\"Comet Opik logo\" src=\"docs/assets/logo-light-mode.svg\" width=\"200\" /\u003e\n            \u003c/picture\u003e\n        \u003c/a\u003e\n        \u003cbr\u003e\n        Opik MCP Server\n    \u003c/div\u003e\n    (Model Context Protocol)\u003cbr\u003e\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\nA Model Context Protocol (MCP) implementation for the \u003ca href=\"https://github.com/comet-ml/opik/\"\u003eOpik platform\u003c/a\u003e with support for multiple transport mechanisms, enabling seamless integration with IDEs and providing a unified interface for Opik's capabilities.\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[![License](https://img.shields.io/github/license/comet-ml/opik-mcp)](https://github.com/comet-ml/opik-mcp/blob/main/LICENSE)\n[![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.11.0-brightgreen)](https://nodejs.org/)\n[![TypeScript](https://img.shields.io/badge/typescript-%5E5.8.2-blue)](https://www.typescriptlang.org/)\n\u003cimg src=\"https://badge.mcpx.dev?status=on\" title=\"MCP Enabled\"/\u003e\n\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://www.comet.com/site/products/opik/?from=llm\u0026utm_source=opik\u0026utm_medium=github\u0026utm_content=website_button\u0026utm_campaign=opik\"\u003e\u003cb\u003eWebsite\u003c/b\u003e\u003c/a\u003e •\n    \u003ca href=\"https://chat.comet.com\"\u003e\u003cb\u003eSlack community\u003c/b\u003e\u003c/a\u003e •\n    \u003ca href=\"https://x.com/Cometml\"\u003e\u003cb\u003eTwitter\u003c/b\u003e\u003c/a\u003e •\n    \u003ca href=\"https://www.comet.com/docs/opik/?from=llm\u0026utm_source=opik\u0026utm_medium=github\u0026utm_content=docs_button\u0026utm_campaign=opik\"\u003e\u003cb\u003eDocumentation\u003c/b\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://glama.ai/mcp/servers/@comet-ml/opik-mcp\" rel=\"nofollow\" target=\"_blank\"\u003e\n      \u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@comet-ml/opik-mcp/badge\" alt=\"Opik Server MCP server\" /\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n\u003e **⚠️ 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.\n\n## 🚀 What is Opik MCP Server?\n\nOpik 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.\n\n\u003cbr\u003e\n\nYou can use Opik MCP Server for:\n* **IDE Integration:**\n  * Seamlessly integrate with Cursor and other compatible IDEs\n  * Provide direct access to Opik's capabilities from your development environment\n\n* **Unified API Access:**\n  * Access all Opik features through a standardized protocol\n  * Leverage multiple transport options (stdio, SSE) for different integration scenarios\n\n* **Platform Management:**\n  * Manage prompts, projects, traces, and metrics through a consistent interface\n  * Organize and monitor your LLM applications efficiently\n\n## Features\n\n- **Prompts Management**: Create, list, update, and delete prompts\n- **Projects/Workspaces Management**: Organize and manage projects\n- **Traces**: Track and analyze trace data\n- **Metrics**: Gather and query metrics data\n\n## Quick Start\n\n### Installation\n\n#### Manual Installation\n```bash\n# Clone the repository\ngit clone https://github.com/comet-ml/opik-mcp.git\ncd opik-mcp\n\n# Install dependencies and build\nnpm install\nnpm run build\n```\n\n### Configuration\n\nCreate a `.env` file based on the example:\n\n```bash\ncp .env.example .env\n# Edit .env with your specific configuration\n```\n\n### Starting the Server\n\n```bash\n# Start with stdio transport (default)\nnpm run start:stdio\n\n# Start with SSE transport for network access (experimental)\nnpm run start:sse\n```\n\n## IDE Integration\n\n### Cursor Integration\n\nTo integrate with Cursor IDE, create a `.cursor/mcp.json` file in your project directory with the following configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"opik\": {\n      \"command\": \"/path/to/node\",\n      \"args\": [\n        \"/path/to/opik-mcp/build/index.js\",\n        \"--apiUrl\",\n        \"https://www.comet.com/opik/api\",\n        \"--apiKey\",\n        \"YOUR_API_KEY\",\n        \"--workspace\",\n        \"default\",\n        \"--debug\",\n        \"true\"\n      ],\n      \"env\": {\n        \"OPIK_API_BASE_URL\": \"https://www.comet.com/opik/api\",\n        \"OPIK_API_KEY\": \"YOUR_API_KEY\",\n        \"OPIK_WORKSPACE_NAME\": \"default\",\n      }\n    }\n  }\n}\n```\n\nReplace `/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.\n\n## Available Commands\n\nThe project includes a Makefile for common operations:\n\n```bash\n# Display all available commands\nmake help\n\n# Run tests\nmake test\n\n# Run transport-specific tests\nmake test-transport\n\n# Start the server with SSE transport (experimental)\nmake start-sse\n\n# Start the server with stdio transport\nmake start-stdio\n```\n\n## Transport Options\n\n### Standard Input/Output\n\nIdeal for local integration where the client and server run on the same machine.\n\n```bash\nmake start-stdio\n```\n\n### Server-Sent Events (SSE)\n\nEnables remote access and multiple simultaneous clients over HTTP. Note that this transport option is experimental.\n\n```bash\nmake start-sse\n```\n\nFor detailed information about the SSE transport, see [docs/sse-transport.md](docs/sse-transport.md).\n\n## Development\n\n### Testing\n\n```bash\n# Run all tests\nnpm test\n\n# Run specific test suite\nnpm test -- tests/transports/sse-transport.test.ts\n```\n\n### Pre-commit Hooks\n\nThis project uses pre-commit hooks to ensure code quality:\n\n```bash\n# Run pre-commit checks manually\nmake precommit\n```\n\n## Documentation\n\n- [SSE Transport](docs/sse-transport.md) - Details on using the SSE transport\n- [API Reference](docs/api-reference.md) - Complete API documentation\n- [Configuration](docs/configuration.md) - Advanced configuration options\n- [IDE Integration](docs/ide-integration.md) - Integration with Cursor IDE\n\n## License\n\nApache 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcomet-ml%2Fopik-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcomet-ml%2Fopik-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcomet-ml%2Fopik-mcp/lists"}