nekolas note

毎日書くことを目指しているけど全然達成できてないブログ

2.1 KB Raw
//! JSON-RPC 2.0 / MCP / LSP の共通メッセージ型(T028)。
//! 参照: contracts/zed-ide-bridge.md
//!
//! LSP(stdio)と MCP(WebSocket)はどちらも JSON-RPC 2.0 を使うため共通化する。

use serde::Deserialize;
use serde_json::Value;

/// MCP プロトコルバージョン。対象 Claude Code CLI と要整合(research R3 のリスク)。
/// 接続時に相手の protocolVersion をエコーする方針なので既定値は新しめにしておく。
pub const MCP_PROTOCOL_VERSION: &str = "2025-03-26";
pub const MCP_PROTOCOL_FALLBACK: &str = "2024-11-05";

/// 受信した JSON-RPC メッセージ(リクエスト/通知/レスポンス兼用)。
#[derive(Debug, Deserialize)]
pub struct RpcMessage {
    #[allow(dead_code)]
    pub jsonrpc: Option<String>,
    /// リクエスト/レスポンスには id がある。通知には無い。
    #[serde(default)]
    pub id: Option<Value>,
    /// メソッド名(リクエスト/通知)。
    #[serde(default)]
    pub method: Option<String>,
    /// パラメータ。
    #[serde(default)]
    pub params: Option<Value>,
}

/// 成功レスポンスを組み立てる。
pub fn rpc_result(id: Value, result: Value) -> Value {
    serde_json::json!({
        "jsonrpc": "2.0",
        "id": id,
        "result": result,
    })
}

/// エラーレスポンスを組み立てる。
pub fn rpc_error(id: Value, code: i64, message: &str) -> Value {
    serde_json::json!({
        "jsonrpc": "2.0",
        "id": id,
        "error": { "code": code, "message": message },
    })
}

/// 通知(id 無し)を組み立てる。
pub fn rpc_notification(method: &str, params: Value) -> Value {
    serde_json::json!({
        "jsonrpc": "2.0",
        "method": method,
        "params": params,
    })
}

/// MCP tools/call の結果は content 配列(text)で返す慣習に従う。
pub fn mcp_text_content(value: &Value) -> Value {
    let text = serde_json::to_string(value).unwrap_or_else(|_| "{}".to_string());
    serde_json::json!({
        "content": [ { "type": "text", "text": text } ],
        "isError": false,
    })
}