机构标准MCP服务器
体现贵机构精英设计和开发标准的定制MCP服务器。作为一名拥有15年以上经验的高级开发人员，负责生成高质量的启动项目并实施设计模式。
特性
8强大的工具
- generate_project_starter -从SRS/系统设计生成完整的启动项目
- 发电机抛光检查表 -审查项目并创建优先改进列表
- 查看\_ \_组件 -根据机构标准审查UI组件
- review_backend_code -审查后端代码的安全性和质量
- generate_component_template -生成生产就绪的组件模板
- get_design_guidelines -准入机构设计指南
- 分析模式使用 -找到应该是内联交互的模态
- check_mobile_desktop_separation -验证PWA移动/桌面分离是否正确
快速开始
1.设置
# Install dependencies
cd agency-standards-mcp
export PATH="$HOME/.local/bin:$PATH"
source .venv/bin/activate
# Set up environment variables
cp .env.example .env
# Edit .env and add your ANTHROPIC_API_KEY2.建立知识库
# Analyze your projects and build knowledge base
python scripts/build_knowledge_base.py这将扫描4+个项目并提取：
- 技术堆栈模式
- 组件结构
- 设计模式（模态与内联）
- 移动/桌面模式
- 图标使用
3.本地测试
# Add to Claude Code
claude mcp add agency-standards --transport stdio -- python src/agency_mcp_server.py
# Verify
claude mcp list
# Test in Claude Code
claude4.尝试使用工具
在Claude Code会话中：
> Show me our design guidelines
> Generate a starter project for a task management app:
SRS: Build a simple task manager with projects, tasks, and tags
System Design: React frontend with Node.js backend, PostgreSQL database
> Review this component against our standards:
[paste component code]
> Analyze modal usage in my project at ~/my-project
> Generate an InlineDeleteButton component设计理念
内联优先，始终专业
- 内联交互 默认情况下（modals仅用于关键确认、身份验证、警报）
- 专业图标 （Lucide React）-永远不要使用表情符号
- 独立的移动/桌面组件 -不仅仅是响应式CSS
- 流畅的动画 （帧运动，300ms过渡）
- TypeScript 用于类型安全
- Tailwind CSS 用于造型
- 干净、现代、光滑 设计
PWA标准
桌面：
- 侧边栏导航
- 多列布局
- 悬停状态
- 键盘快捷键
手机：
- 底部导航（最多4-5个项目）
- 单列布局
- 卡片水平滚动
- 触摸优化（48×48像素命中目标）
- 安全区插图
项目结构
agency-standards-mcp/
├── src/
│ ├── agency_mcp_server.py # Main MCP server with 8 tools
│ ├── agency_mcp_remote.py # Remote HTTP server (Phase 4)
│ ├── analyzers/
│ │ └── project_analyzer.py # Project pattern extraction
│ ├── skills/
│ │ └── AGENCY_STANDARDS_SKILL.md # Complete standards document
│ └── tools/ # Individual tool implementations
├── scripts/
│ └── build_knowledge_base.py # Build knowledge base from projects
├── docs/
│ └── DEVELOPER_GUIDE.md # Developer onboarding guide
├── tests/ # Test suite
├── knowledge_base.json # Analyzed project patterns
├── .env # Environment variables
└── README.md # This file知识库
MCP服务器从您现有的项目中学习：
- 培训师助手演示：Next.js+TypeScript+顺风
- 类短跑演示：Next.js+Supabase+React查询
- 健康前端：Vite+React+TypeScript
- 实践-epd-前端-1：企业web应用程序
提取的图案：
- 技术栈偏好（Next.js、Vite、TypeScript、Tailwind）
- 组件组织（ui/、layout/、share/）
- 设计模式（内联与模态比）
- 移动模式（底部导航、安全区插图）
- 图标库（Lucide React、Heroicons）
配置
环境变量
# .env file
ANTHROPIC_API_KEY=your_api_key_here
PROJECT_PATHS=/path/to/project1,/path/to/project2,...
ADMIN_API_KEY=admin-key-for-remote-server
SERVER_URL=http://localhost:8000
PORT=8000更新标准
要更新设计标准，请编辑：
src/skills/AGENCY_STANDARDS_SKILL.md要在添加项目后重建知识库，请执行以下操作：
python scripts/build_knowledge_base.py用法示例
示例1：生成启动项目
User: Generate a starter project for an inventory management system
MCP Response:
- Complete Next.js + TypeScript project structure
- Separate MobileBottomNav and DesktopSidebar
- Inline delete confirmations
- Professional UI with Lucide icons
- Type-safe with Zod validation
- Ready to customize and deploy示例2：评审组件
User: Review this DeleteButton component
MCP Response:
✅ Excellent: TypeScript types, professional icons
⚠️ Issue: Uses modal for confirmation (should be inline)
💡 Suggestion: [Shows inline pattern code example]示例3：波兰检查表
User: Generate polish checklist for ~/my-project
MCP Response:
## HIGH PRIORITY
- [ ] Convert 3 modals to inline interactions (locations listed)
- [ ] Add separate mobile/desktop navigation components
- [ ] Fix 5 accessibility violations
## MEDIUM PRIORITY
- [ ] Add loading states to async actions
- [ ] Implement error boundaries
[Complete prioritized checklist with time estimates]发展
添加新工具
- 添加工具功能
src/agency_mcp_server.py:
@app.tool()
async def my_new_tool(param: str) -> str:
"""Tool description"""
# Implementation
return result- 本地测试：
claude mcp remove agency-standards
claude mcp add agency-standards --transport stdio -- python src/agency_mcp_server.py运行测试
# Run test suite
python -m pytest tests/
# Test specific tool
python src/agency_mcp_server.py --test generate_project_starter部署（第4阶段）
部署到Railway/Render/DigitalOcean以进行远程团队访问。
看 docs/DEPLOYMENT.md 获取完整说明。
成本估算
10名开发人员的每月费用：
- API克劳德：约12美元/月
- 项目世代：约7.50美元 - 点评：约3.00美元 - 其他查询：约1.50美元
- 托管：10-50美元/月
- 铁路：$5/月 - 渲染：每月7美元 - DigitalOcean：每月12美元
总计：约20-60美元/月
非常实惠，可以在整个团队中保持高质量的标准！
支持
- 文档：参见
docs/文件夹 - 问题：在存储库中创建问题
- 更新：提取最新更改并重建知识库
后续步骤
- ✅ 第一阶段：项目设置-完成
- ✅ 第2阶段：知识库-完成
- ✅ 第3阶段：MCP工具-完成
- ⏳ 阶段4：具有身份验证的远程服务器
- ⏳ 第五阶段：开发人员入职培训系统
- ⏳ 第6阶段：部署和测试
- ⏳ 第7阶段：文件和移交
版本
v1.0.0 -初始版本包含8个核心工具
______________________________________________________________________
内置❤️ 维护精英软件开发标准