diff --git a/README.md b/README.md
index b63a550..34d17a4 100644
--- a/README.md
+++ b/README.md
@@ -29,7 +29,7 @@ WCDB (微信的 SQLCipher 封装) 会在进程内存中缓存派生后的 raw ke
 
 - Python 3.10+
 - 微信 4.x
-- `pip install pycryptodome`
+- `pip install -r requirements.txt`
 
 Windows：
 
@@ -46,9 +46,17 @@ Linux：
 ### 安装依赖
 
 ```bash
-pip install pycryptodome
+pip install -r requirements.txt
 ```
 
+Windows 如果遇到权限不足或全局环境不可写，可以改用：
+
+```bash
+py -m pip install --user -r requirements.txt
+```
+
+如果需要读取受保护的进程或把依赖安装到系统 Python，也可能需要以管理员身份打开终端。
+
 ### 快速开始
 
 Windows：
@@ -104,7 +112,7 @@ Linux 版 `config.json` 示例：
 将微信数据查询能力接入 [Claude Code](https://claude.ai/claude-code)，让 AI 直接读取你的微信消息。
 
 ```bash
-pip install mcp
+pip install -r requirements.txt
 ```
 
 注册到 Claude Code：
diff --git a/USAGE.md b/USAGE.md
index 0d8717c..0b356ce 100644
--- a/USAGE.md
+++ b/USAGE.md
@@ -219,12 +219,12 @@ Claude 会调用 `get_chat_history(chat_name="██群", limit=500)` 获取消
 
 ## Setup / 配置方法
 
-```bash
-# 1. 安装依赖
-pip install mcp pycryptodome
-
-# 2. 注册到 Claude Code
-claude mcp add wechat -- python C:\path\to\mcp_server.py
+```bash
+# 1. 安装依赖
+pip install -r requirements.txt
+
+# 2. 注册到 Claude Code
+claude mcp add wechat -- python C:\path\to\mcp_server.py
 
 # 3. 在 Claude Code 中直接对话
 claude
diff --git a/requirements.txt b/requirements.txt
new file mode 100644
index 0000000..af9f591
--- /dev/null
+++ b/requirements.txt
@@ -0,0 +1,3 @@
+pycryptodome>=3.19,<4
+zstandard>=0.22,<1
+mcp>=1.0,<2