# 1. 创建虚拟环境并安装（需 Python 3.11+ 或 uv）
uv venv
uv pip install -e ".[dev]"

# 2. 跑测试
uv run pytest tests -q

# 3. 启动服务器（stdio，供客户端接入）
uv run python -m mcp_personal

# 4. 冒烟测试：真实 stdio 子进程链路
uv run python scripts/smoke_stdio.py

# 5. 查看服务器注册的能力清单（Tools/Prompts/Resources）
uv run python scripts/verify_capabilities.py

# 6. 调试：官方 MCP Inspector
uv run mcp dev src/mcp_personal/server.py

# 终端 1：启动 HTTP 服务（默认 127.0.0.1:8000，--host 0.0.0.0 可局域网访问）
uv run python scripts/run_http.py --port 8000

# 终端 2：用官方客户端验证链路
uv run python scripts/client_http_check.py --url http://127.0.0.1:8000/mcp

# 终端 1：带鉴权启动
MCP_API_TOKEN=my-secret uv run python scripts/run_http.py --port 8000

# 终端 2：带 token 验证
uv run python scripts/client_http_check.py --url http://127.0.0.1:8000/mcp --token my-secret

├── PLAN.md            # 项目规划书
├── pyproject.toml     # 依赖与打包
├── src/mcp_personal/  # 服务器代码
│   ├── server.py      # FastMCP 入口（注册全部原语）
│   ├── tools/         # Tool：paper(检索)/dataset(摸底)/scaffold(课设)/devtools(目录树)
│   ├── prompts.py     # Prompt：literature_review 文献综述框架
│   └── resources.py   # Resource：papers://list 本地论文库
├── papers/            # 本地论文库（放 PDF）
├── datasets/          # 竞赛数据集（dataset_info 工具使用）
├── tests/             # pytest 测试（13 个）
├── .github/workflows/ # CI：push/PR 自动跑测试
├── scripts/           # smoke_stdio.py / verify_capabilities.py
├── .cursor/ .vscode/  # 客户端接入配置
└── README.md