MCP 伺服器

情境

你們公司有套內部的 acme-lint（檢查公司特有的 API 使用規範，例如「不得直接呼叫 legacy payment 端點」）。你想讓 OCR 的評審 agent 在 Main 迴圈裡直接跑 acme-lint 拿結果當脈絡，而不是靠模型瞎猜。

Step 1 — 寫一個極簡 MCP server（stdio + tools/list + tools/call）

# acme-lint-mcp/server.js
const { Server } = require('@modelcontextprotocol/sdk/server/index.js')
const { StdioServerTransport } = require('@modelcontextprotocol/sdk/server/stdio.js')

const server = new Server({ name: 'acme-lint', version: '1.0.0' })
server.setRequestHandler(server.listTools, async () => ({
  tools: [{
    name: 'run_acme_lint',
    description: '對指定檔案跑 acme-lint，回傳違規清單',
    inputSchema: { type: 'object', properties: { path: { type: 'string' } } }
  }]
}))
server.setRequestHandler(server.callTool, async (req) => {
  const { path } = req.params.arguments
  const out = execSync(`acme-lint --json ${path}`)
  return { content: [{ type: 'text', text: out.toString() }] }
})
server.connect(new StdioServerTransport())

Step 2 — 註冊進 OCR 並只暴露這個工具

ocr config set mcp_servers.acmelint.command     node
ocr config set mcp_servers.acmelint.args        '["/path/to/acme-lint-mcp/server.js"]'
ocr config set mcp_servers.acmelint.tools       '["run_acme_lint"]'

Step 3 — 跑評審，觀察 agent 是否用了它

ocr review --format json --audience agent
# session JSONL 中可看到 tool_call: run_acme_lint

Step 4 — 驗證工具真的被當脈絡（看 viewer）

開 viewer，找 main_task 泳道，看 tool call 的結果有沒有影響模型的 code_comment（例如「此檔違反 acme-lint 的 legacy payment 規則」）。

為什麼選這條審查路徑

公司特有規範（legacy 端點禁用的黑白名單）是模型不可能憑常識知道的——不給它工具，它就只能「猜」。把 acme-lint 包成 MCP 工具，讓 Agent 在需要時以確定性工具取得確定性事實，評論就從「猜測」升級成「引用公司規則」。這正是 MCP 頁開頭說的「評審需要 diff 之外的脈絡」的最佳實例。

預期產出

✓ MCP server "acmelint" started
✓ Tools registered: run_acme_lint
Reviewing 4 files...
  agent called run_acme_lint on payment/gateway.go
  comment: "此檔呼叫 legacy payment 端點，違反公司規範 (acme-lint rule LP-001)"