cd chrome-bookmanager
pip install -e .

# stdio 模式（Claude Desktop 默认使用此模式）
bookmarks-mcp

# 开发调试
python -m bookmarks_mcp.server

{
  "mcpServers": {
    "bookmarks-mcp": {
      "command": "python",
      "args": ["-m", "bookmarks_mcp.server"]
    }
  }
}

bookmarks-mcp/
├── pyproject.toml
├── README.md
├── src/
│   └── bookmarks_mcp/
│       ├── __init__.py
│       ├── server.py          # FastMCP 入口 + 工具注册
│       ├── bookmarks/
│       │   ├── __init__.py
│       │   ├── manager.py     # 通用 CRUD 操作（外观模式）
│       │   └── models.py      # Pydantic 数据模型
│       ├── browsers/
│       │   ├── __init__.py
│       │   ├── base.py        # 浏览器适配器基类（抽象接口）
│       │   ├── chrome.py      # Chrome 适配器
│       │   └── edge.py        # Edge 适配器（继承 Chrome）
│       └── utils/
│           ├── __init__.py
│           └── paths.py       # 跨平台路径工具
└── tests/
    ├── __init__.py
    └── test_chrome.py

本地浏览器书签文件 (Bookmarks JSON)
    ↓ 读取
Bookmarks MCP Server (本地进程)
    ↓ 通过 MCP 协议 (stdio)
AI 客户端 (如 Claude Desktop)
    ↓ 可能发送至云端
AI 服务提供商服务器

# 安装开发依赖
pip install -e ".[dev]"

# 运行测试
pytest tests/ -v

# 代码检查
ruff check src/