linkyun-ops-mcp

MCP adapter for LinkYun operations metrics.

The server exposes MCP tools for Agents and forwards every request to the linkyun-agent Ops HTTP API. It does not connect to databases, generate SQL, define metrics, or make authorization decisions.

Tools

• ops_list_metrics: list metrics available to the configured operator token.
• ops_query_metric: query one backend metric with the backend query contract.
• ops_get_home_recommendations: get home banner/platform/hot ranking config.
• ops_preview_home_recommendations: validate partial home recommendation config.
• ops_set_home_recommendations: replace supplied home recommendation modules with audit.
• ops_list_agents: list/find workspace agents with operations fields.
• ops_get_agent: get one workspace agent by code.
• ops_list_agent_tags: list active tag library and discover categories.
• ops_update_agent: update allowed Agent operations fields with audit.

Configuration

LINKYUN_OPS_BASE_URL=http://localhost:8080
LINKYUN_OPS_TOKEN=ops_...
LINKYUN_OPS_CLIENT=linkyun-ops-mcp
LINKYUN_OPS_TIMEOUT_MS=10000

Development

npm.cmd install
npm.cmd run build
npm.cmd test
npm.cmd run lint
openspec validate ops-mcp-adapter-mvp --strict
openspec validate ops-agent-management-tools --strict

Claude Desktop Example

{
  "mcpServers": {
    "linkyun-ops": {
      "command": "node",
      "args": ["D:/Projects/linkyun/linkyun-ops/linkyun-ops-mcp/dist/index.js"],
      "env": {
        "LINKYUN_OPS_BASE_URL": "http://localhost:8080",
        "LINKYUN_OPS_TOKEN": "ops_..."
      }
    }
  }
}

Agents must convert relative time phrases into explicit RFC3339 timestamps before calling ops_query_metric.

Metric Notes

ops_query_metric forwards metric codes to the backend Ops API. Adding a new backend metric usually does not require an MCP tool schema change unless the query contract itself changes.

Common backend metric codes:

• accounts_created
• registered_users
• agents_created
• chat_messages
• agent_assistant_messages
• agent_likes
• moment_likes
• moment_favorites

agent_likes, moment_likes, and moment_favorites support rank in the backend. They also accept optional agent_code for aggregate, timeseries, and compare queries; for Moment metrics, agent_code means Moments belonging to that Agent.