Voice / Client
  -> API v1 Dispatch
  -> Safety Checks
  -> Obsidian / App / Claude Code / Pending Action
  -> Spoken Result

统一 HTTP API
  -> 白名单边界
  -> 语音友好返回
  -> 待确认动作
  -> 多语言接入
  -> 本机桌面执行

git clone git@github.com:jijiutong/xiaozhi-desktop-mcp.git
cd xiaozhi-desktop-mcp
python3 -m venv .venv
. .venv/bin/activate
pip install -e .
cp .env.example .env

OBSIDIAN_VAULT=/path/to/your/obsidian-vault
DEFAULT_PROJECT_ROOT=/path/to/your/project
CC_ALLOWED_PROJECTS=/path/to/your/project
ALLOWED_APPS=Obsidian,Terminal,Google Chrome

xiaozhi-desktop-http

curl http://127.0.0.1:8765/api/v1/health

POST /api/v1/dispatch

{
  "request_id": "client-001",
  "action": "list_projects",
  "params": {}
}

{
  "success": true,
  "request_id": "client-001",
  "action": "list_projects",
  "spoken_message": "当前有 1 个允许的项目。",
  "error_spoken_message": "",
  "error": "",
  "data": {}
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class DesktopMcpDemo {
  public static void main(String[] args) throws Exception {
    String body = """
      {
        "request_id": "java-demo-1",
        "action": "list_projects",
        "params": {}
      }
      """;

    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("http://127.0.0.1:8765/api/v1/dispatch"))
        .header("Content-Type", "application/json")
        .POST(HttpRequest.BodyPublishers.ofString(body))
        .build();

    HttpResponse<String> response = HttpClient.newHttpClient()
        .send(request, HttpResponse.BodyHandlers.ofString());

    System.out.println(response.body());
  }
}

import requests

payload = {
    "request_id": "python-demo-1",
    "action": "ask_cc_project",
    "params": {
        "project": "your-project-alias",
        "text": "帮我检查这个项目的 README。"
    },
}

response = requests.post(
    "http://127.0.0.1:8765/api/v1/dispatch",
    json=payload,
    timeout=10,
)

data = response.json()
print(data["spoken_message"] if data["success"] else data["error_spoken_message"])

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	body := []byte(`{
	  "request_id": "go-demo-1",
	  "action": "list_projects",
	  "params": {}
	}`)

	resp, err := http.Post(
		"http://127.0.0.1:8765/api/v1/dispatch",
		"application/json",
		bytes.NewReader(body),
	)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, _ := io.ReadAll(resp.Body)
	fmt.Println(string(data))
}

curl http://127.0.0.1:8765/api/v1/actions

小智，记一下：这个项目先做成桌面 MCP。
小智，打开这个项目的 Claude Code。
小智，把这个任务交给 cc：检查 README 是否清楚。
小智，看看 cc 现在卡在哪。
小智，搜索 Obsidian 里关于桌面 MCP 的笔记。
小智，创建一个待确认动作，让 cc 继续。