MCP Server Req Refine

🚀 需求優化 MCP 服務器

ReqRefine 是一款基於 MCP 的對話式服務，藉助戰略性提問來強化需求收集工作。它能夠引導用戶全面揭示需求，挖掘潛在的隱含條件，並將對話內容轉化為結構化規範。ReqRefine 讓需求收集從單方面的採訪轉變為協作式的發現過程。

✨ 主要特性

組件

資源

該服務器實現了一個簡易的筆記存儲系統：

• 採用自定義的 note:// URI 方案來訪問單個筆記。
• 每個筆記資源包含名稱、描述，且格式類型為 text/plain。

提示語

該服務器提供一項提示功能：

• 總結筆記：為所有存儲的筆記生成摘要。
  • 可通過可選的 “風格” 參數控制詳細程度（簡潔/詳細）。
  • 依據所有當前筆記和風格偏好生成提示內容。

工具

該服務器實現了一個工具：

• 添加筆記：向服務器添加新的筆記。
  • 要求傳入 “名稱” 和 “內容” 這兩個必需的字符串參數。
  • 更新服務器狀態，並通知客戶端資源發生更改。

📦 安裝指南

克勞德桌面

• 在 MacOS 上：配置文件路徑為 ~/Library/Application\ 支持/Claude/claude_desktop_config.json。
• 在 Windows 上：配置文件路徑為 %APPDATA%/Claude/claude_desktop_config.json。

🚀 快速開始

開發

構建和發佈

為了準備分發包，可按以下步驟操作：

1. 同步依賴項並更新鎖定文件：

uv sync

2. 構建包分佈：

uv build

這將在 dist/ 目錄中創建源代碼和輪分佈。

3. 發佈到 PyPI：

uv publish

注意：您需要通過環境變量或命令行標誌設置 PyPI 憑證：

• 令牌：--token 或 UV_PUBLISH_TOKEN。
• 或用戶名/密碼：--username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD。

調試

由於 MCP 服務器通過標準輸入輸出運行，調試可能具有一定挑戰性。為了獲得最佳的調試體驗，我們強烈推薦使用 MCP 檢查器。

您可以使用 npm 通過以下命令啟動 MCP 檢查器：

npx @modelcontextprotocol/inspector uv --directory D:\code\req-refine run req-refine

在啟動後，檢查器會顯示一個 URL，您可以在瀏覽器中訪問該 URL 開始調試。