AI服务器工具集

# 1. Server
cd server
cp ../.env.example ../.env   # Edit: set MCP_API_KEY, JWT_SECRET, add AI provider keys
npm install
npm run build
npm start

# 2. Client (in a new terminal)
cd client
npm install
npm run dev

brew install cloudflared
cloudflared tunnel --url http://localhost:3030

npm run seed

./ops/macos/install.sh

launchctl print gui/$(id -u)/com.mcp-ai-server.local
tail -f ~/Library/Logs/mcp-ai-server/out.log
tail -f ~/Library/Logs/mcp-ai-server/err.log

./ops/macos/uninstall.sh

caffeinate -dimsu &          # Temporary — kill the process to re-enable sleep
sudo pmset -c sleep 0        # Persistent — revert with: sudo pmset -c sleep 10

cd server
npm test          # single run
npm run test:watch # watch mode

cd client
npm run lint

# In another terminal:
npm run smoke

mcp-ai-server/
├── .editorconfig             # Editor formatting rules
├── .env.example              # Environment template
├── .gitignore
├── SECURITY.md               # Security & code scanning policy
├── .github/workflows/
│   ├── ci.yml                # CI: install → lint → test → build
│   └── codeql.yml            # CodeQL Code Scanning workflow
├── knowledge/                # Markdown files for knowledge_search tool
│   └── policies.md
├── org/                      # Org-wide templates
│   ├── _org_checklist.md     # Onboarding checklist for new repos
│   └── reusable-codeql.yml   # Reusable CodeQL workflow (workflow_call)
├── client/                   # Next.js 14 web app (AI Chat Hub)
│   ├── package.json
│   ├── next.config.ts
│   ├── tailwind.config.ts
│   ├── public/
│   │   ├── manifest.json     # PWA manifest
│   │   └── sw.js             # Service worker
│   └── src/
│       ├── app/              # App Router pages
│       │   ├── layout.tsx    # Root layout + meta
│       │   ├── login/        # Auth pages
│       │   ├── signup/
│       │   └── (app)/        # Protected pages
│       │       ├── chat/     # AI chat interface
│       │       ├── dashboard/# Usage stats
│       │       ├── admin/    # Model/user/key mgmt
│       │       ├── settings/ # User preferences
│       │       └── install/  # PWA install guide
│       ├── components/       # React components
│       ├── stores/           # Zustand state
│       ├── hooks/            # Custom hooks (PWA, etc.)
│       ├── lib/              # API client, utils
│       └── types/            # Shared TypeScript types
├── public/
│   └── .well-known/
│       └── mcp-verification.txt
├── ops/                      # Deployment & operations
│   ├── cloudflare/           # Tunnel setup
│   ├── macos/                # launchd service
│   └── openai-form-pack.md   # OpenAI registration guide
└── server/
    ├── package.json
    ├── tsconfig.json
    └── src/
        ├── index.ts           # Express entry point
        ├── config.ts          # Env validation (Zod)
        ├── logger.ts          # Structured JSON logger
        ├── smoke.ts           # Smoke test script
        ├── api/
        │   └── routes.ts      # REST API (auth, models, admin, stats)
        ├── auth/
        │   ├── middleware.ts   # x-api-key + JWT guards
        │   └── jwt.ts         # JWT sign/verify + user CRUD
        ├── chat/
        │   ├── routes.ts      # Chat endpoints + SSE streaming
        │   └── service.ts     # Conversation/message CRUD
        ├── db/
        │   ├── connection.ts  # SQLite singleton
        │   ├── schema.ts      # All table definitions
        │   └── seed.ts        # Demo data
        ├── llm/
        │   ├── router.ts      # Smart AI router (auto-fallback)
        │   ├── types.ts       # LLM type definitions
        │   └── providers/
        │       ├── catalog.ts          # Provider & model registry
        │       ├── openai-compatible.ts # Groq/Cerebras/Together/etc.
        │       └── gemini.ts           # Google Gemini adapter
        ├── mcp/
        │   ├── server.ts      # MCP Server factory
        │   └── routes.ts      # POST /mcp Express router
        └── tools/
            ├── registry.ts    # Tool registration + Zod→JSON Schema
            ├── fleet.ts       # fleet_list_vehicles, fleet_update_status
            ├── wash.ts        # wash_log_create
            ├── sales.ts       # sales_log_create
            ├── reports.ts     # report_daily_summary
            └── knowledge.ts   # knowledge_search

# 1. Health check
curl -s http://localhost:3030/health | grep '"ok":true'

# 2. MCP tools/list (6 tools expected)
curl -s http://localhost:3030/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'x-api-key: YOUR_KEY' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' \
  | grep -o '"name":"[^"]*"' | wc -l

# 3. Auth enforcement (expect 401)
curl -s -o /dev/null -w '%{http_code}' http://localhost:3030/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

# 4. Verification file (expect plain text token)
curl -i http://localhost:3030/.well-known/mcp-verification.txt

# 5. Smoke test (all-in-one)
cd server && MCP_API_KEY=YOUR_KEY npm run smoke

# 6. launchd status (if installed)
launchctl print gui/$(id -u)/com.mcp-ai-server.local
tail -5 ~/Library/Logs/mcp-ai-server/out.log

gh api \
  -X PUT \
  -H "Accept: application/vnd.github+json" \
  /repos/<OWNER>/<REPO>/branches/main/protection \
  -f required_status_checks[strict]=true \
  -f 'required_status_checks[contexts][]=code-scanning' \
  -f 'required_status_checks[contexts][]=Server (install → build → test)' \
  -f 'required_status_checks[contexts][]=Client (install → lint → build)' \
  -f enforce_admins=true \
  -f restrictions=