使用说明

ORI工作流的MCP服务器

模型上下文协议（MCP）服务器，用于执行具有SME质量门和结构化上下文保存的ORI（优化研究实施）工作流。

ORI是什么？

ORI是一个多阶段工作流框架，专为复杂的软件工程任务而设计：

第0阶段（战略）： 分析任务，设计研究策略，选择最优模型
第一阶段（研究）： 通过网络搜索、代码示例和文档进行深入研究
第2阶段（验证）： 交叉验证调查结果，评估安全性/性能
第2.5阶段（中小企业质量门）： 可选主题专家评审（安全、合规等）
第3阶段（实施）： 使用经过验证的方法执行解决方案
第4阶段（文件编制）： 更新文档、更改日志、生成摘要

特性

🛠️ 工具

execute_ori：执行完整的ORI工作流程并跟踪进度
validate_config：根据架构验证ORI配置
analyze_task：飞行前分析（复杂性、领域、风险标志）

📚 资源

静态资源：

docs://ori/workflow -完整的ORI工作流程规范
docs://ori/agents/taxonomy -代理架构指南
docs://ori/agents/sme-security -安全中小企业（OWASP前10名）
schema://ori/config -配置JSON模式
schema://ori/handoff-packet -切换数据包模式

动态资源（未来）：

logs://workflow/{traceId}/execution -工作流执行日志
logs://workflow/{traceId}/handoff-packets -阶段间背景
logs://workflow/{traceId}/sme-reviews -中小企业调查结果

🔄 同步机制

文件监视器： 自动检测ORI资源文件的更改
Git同步： 自动提交并推送到GitHub
NPM发布： 在版本颠簸时自动发布
热重新加载： 配置更改时重新启动MCP服务器

📊 质量保证

中小企业代理： 专业质量门（安全、合规、代码质量、性能）
交接包： 零上下文丢失阶段转换
跟踪ID: 带有反馈回路的端到端跟踪
安全挂钩： 阶段前/阶段后验证

安装

选项1:NPM包（推荐）

安装MCP服务器：

npm install -g @grandinharrison/mcp-server-ori

配置Claude桌面：

macOS： 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json

窗户： 编辑 %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ori-workflow": {
      "command": "npx",
      "args": ["-y", "@grandinharrison/mcp-server-ori"],
      "env": {
        "LOG_LEVEL": "info"
      }
    }
  }
}

完全重新启动Claude Desktop（退出并重新打开）
通过检查聊天输入区域中的MCP服务器指示器来验证安装

方案2：地方发展

git clone https://github.com/grandinh/mcp-server-ori.git
cd mcp-server-ori
npm install
npm run build

配置Claude Desktop以使用本地构建：

{
  "mcpServers": {
    "ori-workflow-dev": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server-ori/dist/index.js"],
      "env": {
        "LOG_LEVEL": "debug",
        "ENABLE_SYNC": "true"
      }
    }
  }
}

用法

基本工作流执行

Use the execute_ori tool with task: "Implement JWT authentication for Express API"

MCP服务器将返回结构化指令，供Claude执行ORI工作流阶段。

配备中小企业质量门

Use the execute_ori tool with:
- task: "Implement JWT authentication for Express API"
- config: { sme_enabled: true, security_sme: true }

任务分析

Use the analyze_task tool with task: "Refactor user authentication system"

退货：

复杂性（低/中/高）
域名分类
清晰度得分（0-1）
风险标志（安全、隐私、合规）
推荐型号（Opus/Sonet/Haiku）
预计持续时间

配置验证

Use the validate_config tool with config_path: "/path/to/ori-config.json"

返回验证错误和警告。

配置

创建 ~/.claude/ori-config.json:

{
  "version": "1.2.0",
  "sme_agents": {
    "enabled": false,
    "security": {
      "enabled": false,
      "auto_invoke_on_keywords": ["auth", "crypto", "password", "jwt"],
      "block_on_critical": true
    },
    "compliance": {
      "enabled": false
    },
    "code_quality": {
      "enabled": false
    },
    "performance": {
      "enabled": false
    }
  },
  "safety_hooks": {
    "enabled": true,
    "pre_phase": {
      "phase_3": ["git_check", "path_validation"]
    }
  },
  "logging": {
    "enabled": true,
    "log_directory": ".claude/ori-logs",
    "log_handoff_packets": true
  }
}

建筑

┌─────────────────────────────────────────────────────────┐
│           ORI MCP Server (Hybrid Architecture)          │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  ┌─────────────────┐         ┌──────────────────────┐  │
│  │   TOOLS Layer   │         │  RESOURCES Layer     │  │
│  ├─────────────────┤         ├──────────────────────┤  │
│  │ execute_ori     │         │ Static Resources:    │  │
│  │ validate_config │         │  • docs://ori/...    │  │
│  │ analyze_task    │         │  • schema://ori/...  │  │
│  └─────────────────┘         │ Dynamic Resources:   │  │
│                              │  • logs://workflow/  │  │
│                              └──────────────────────┘  │
│                                                         │
│  ┌──────────────────────────────────────────────────┐  │
│  │         Sync Engine (3-way sync)                 │  │
│  ├──────────────────────────────────────────────────┤  │
│  │ • File Watcher → Git Push                        │  │
│  │ • Version Bumper → NPM Publish                   │  │
│  │ • Hot Reload → MCP Server Restart                │  │
│  └──────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────┘

反馈

执行ORI工作流后，您将收到一个反馈URL：

https://github.com/grandinh/mcp-server-ori/issues/new?template=workflow-feedback.yml&trace_id=<your-trace-id>

您的反馈有助于改善每个人的ORI工作流程！

发展

构建

npm run build

观看模式

npm run watch

棉绒

npm run lint
npm run lint:fix

测试

npm test

故障排除

MCP服务器未显示

验证配置文件位置和语法（必须是有效的JSON）
检查克劳德桌面日志：
- macOS： ~/Library/Logs/Claude/
- 窗户： %APPDATA%/Claude/logs/
确保已安装Node.js>=18.0.0
完全退出并重新启动Claude Desktop（而不仅仅是重新加载）

stderr与stdout错误

MCP协议要求所有日志都转到 stderr，从来没有 stdout。此服务器将所有输出正确路由到 stderr.

资源未加载

验证 resources/ 目录存在并包含：

ori.md
ori-config.json
agents/README.md
agents/sme-security.md
schemas/handoff-packet.json

贡献

看贡献.md 发展指南。

许可证

麻省理工学院©哈里森·格兰丁

链接

npm： https://www.npmjs.com/package/@grandinharrison/mcp服务器ori
github： https://github.com/grandinh/mcp-server-ori
问题： https://github.com/grandinh/mcp-server-ori/issues
MCP文件： https://modelcontextprotocol.io

致谢

内置模型上下文协议SDK
灵感来自 ORI工作流框架