pip install -e ".[all]"

OSS_AGENT_GITHUB_TOKEN=ghp_xxxxxxxx

{
  "mcpServers": {
    "github-trend": {
      "command": "mcp-oss-agent",
      "args": ["serve"],
      "env": {
        "OSS_AGENT_GITHUB_TOKEN": "ghp_xxxxxxxx"
      }
    }
  }
}

# 查看帮助
mcp-oss-agent --help

# 搜索仓库
mcp-oss-agent search "python web framework" --language python --per-page 10

# 分析仓库
mcp-oss-agent analyze jankoli mcp-server-github-trend

# 让智能体帮你解决问题
mcp-oss-agent solve "部署一个 Python 后端服务" --output-lang zh

# 启动 Web 仪表盘
mcp-oss-agent web --host 127.0.0.1 --port 8080

flowchart TB
    User[用户请求]
    Intent[意图理解引擎]
    Discovery[GitHub 发现层]
    Analyzer[仓库分析引擎]
    Planner[方案规划器]
    Executor[安全执行器]
    Cache[(多级缓存)]
    Metrics[指标与日志]

    User --> Intent
    Intent --> Discovery
    Discovery --> Cache
    Discovery --> Analyzer
    Analyzer --> Planner
    Planner --> Executor
    Executor --> Metrics

src/mcp_server_github_trend/
├── __init__.py
├── __main__.py
├── server.py              # MCP 服务器入口
├── cli.py                 # Typer 命令行接口
├── web.py                 # FastAPI 仪表盘
├── config.py              # Pydantic 配置
├── models.py              # Pydantic 领域模型
├── github_client.py       # 异步 GitHub REST 客户端
├── analyzer.py            # 仓库健康分析引擎
├── intent.py              # 意图理解引擎
├── planner.py             # 方案规划引擎
├── executor.py            # 安全命令执行器
├── cache/                 # 内存 / 磁盘 / Redis 缓存
└── utils/                 # 日志、重试、国际化

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

# 运行测试
pytest tests/ -q

# 代码检查
ruff check src tests
ruff format --check src tests
mypy src

# 构建
python -m build