agentops-mcp-server 0.0.8

Simple MCP server for AgentOps with Zed

Zed AgentOps

• Cross-session handoff (.agent/handoff.md)
• CI/CD-like loop: edit -> verify -> commit -> update handoff
• Test generation as part of the loop (agent adds tests, then verify)

Quick start

zed-agentops-init project_name

Installation

brew tap rioriost/agentops_mcp_server
brew install agentops_mcp_server

Use zed-agentops-init.sh to scaffold a directory (it creates .rules, .zed/, .agent, and .zed/scripts/verify). It also auto-appends common entries to .gitignore (including .zed/ and .agent/). Open the directory in Zed and use the Agent Panel.

Where things live

• .rules : project rules auto-injected into Zed Agent context
• .zed/tasks.json : reusable Tasks (verify, git helpers)
• .zed/scripts/verify : the single entry point for build/test/lint (extend as needed)
• .agent/handoff.md : cross-session handoff (source of truth)
• .agent/session-log.jsonl : optional event log (append-only)
• .agent/checkpoints/ : diff checkpoints (json snapshots)
• src/agentops_mcp_server/ : optional MCP server scaffold (Python)

MCP Server (Zed)

The MCP server lives in src/agentops_mcp_server/main.py and exposes a minimal JSON-RPC 2.0 stdio protocol compatible with Zed. It reads one JSON object per line from stdin and writes JSON-RPC responses to stdout. Supported methods include initialize, initialized, tools/list, tools/call, shutdown, and exit.

Run it with:

• uv run agentops_mcp_server

Zed (MCP Server):

{
  "agentops-server": {
    "command": "/opt/homebrew/bin/agentops_mcp_server",
    "args": [],
    "env": {}
  }
}

Tool Settings (settings.json):

"agent": {
  "tool_permissions": {
    "tools": {
      "create_directory": {
        "default": "allow"
      },
      "fetch": {
        "default": "allow"
      },
      "web_search": {
        "default": "allow"
      },
      "terminal": {
        "default": "allow"
      },
      "mcp:agentops-server:handoff_read": {
        "default": "allow"
      },
      "mcp:agentops-server:handoff_update": {
        "default": "allow"
      },
      "mcp:agentops-server:handoff_normalize": {
        "default": "allow"
      },
      "mcp:agentops-server:session_log_append": {
        "default": "allow"
      },
      "mcp:agentops-server:session_capture_context": {
        "default": "allow"
      },
      "mcp:agentops-server:session_checkpoint": {
        "default": "allow"
      },
      "mcp:agentops-server:session_diff_since_checkpoint": {
        "default": "allow"
      },
      "mcp:agentops-server:repo_verify": {
        "default": "allow"
      },
      "mcp:agentops-server:repo_commit": {
        "default": "allow"
      },
      "mcp:agentops-server:repo_status_summary": {
        "default": "allow"
      },
      "mcp:agentops-server:repo_commit_message_suggest": {
        "default": "allow"
      },
      "mcp:agentops-server:tests_suggest": {
        "default": "allow"
      },
      "mcp:agentops-server:tests_suggest_from_failures": {
        "default": "allow"
      },
      "mcp:agentops-server:commit_if_verified": {
        "default": "allow"
      },
      "mcp:agentops-server:log_append": {
        "default": "allow"
      }
    }
  },
  "default_model": {
    "provider": "copilot_chat",
    "model": "gpt-5.2-codex"
  }
},

MCP tools (snake_case):

• handoff_read
• handoff_update
• handoff_normalize
• session_log_append
• session_capture_context
• session_checkpoint
• session_diff_since_checkpoint
• repo_verify
• repo_commit
• repo_status_summary
• repo_commit_message_suggest
• tests_suggest
• tests_suggest_from_failures
• Aliases: dotted names (e.g. handoff.read) map to snake_case for compatibility.
• Legacy: commit_if_verified, log_append

Usage notes:

• Call tools/list to enumerate tools. Example request: {"jsonrpc":"2.0","id":1,"method":"tools/list"}
• Call tools/call to invoke a tool. Example request: {"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"handoff_update","arguments":{"summary":"Wrap up MCP tools","decisions":"Added structured handoff updates","next_actions":"Add tests for handoff parsing"}}}
• Successful responses include a result; failures include an error with code and message.

Then register the MCP server in Zed and grant tool permissions as you prefer.

License

MIT