req-refine MCP server

req-refine MCP サーバー

ReqRefine は、戦略的な質問を通じて要件の収集を強化する MCP 会話サービスです。ユーザーが包括的なニーズを明らかにし、暗黙の要件を発見できるよう導き、対話を構造化された仕様に変換します。ReqRefine は、要件収集を一方的な聞き取りから、協力的な発見プロセスへと変えます。

コンポーネント

リソース

このサーバーは、次の機能を備えたシンプルなメモ保存システムを実装しています。

• 個々のメモにアクセスするためのカスタム note:// URI スキーム
• 各メモリソースは、名前、説明、text/plain MIME タイプを持ちます

プロンプト

このサーバーは、次のプロンプトを 1 つ提供します。

• summarize-notes：保存されたすべてのメモの要約を作成します
  • 詳細度（brief/detailed）を指定する任意の「style」引数
  • 現在のすべてのメモとスタイルの指定を組み合わせてプロンプトを生成します

ツール

このサーバーは、次のツールを 1 つ実装しています。

• add-note：サーバーに新しいメモを追加します
  • 必須の文字列引数「name」と「content」を受け取ります
  • サーバーの状態を更新し、リソースの変更をクライアントに通知します

設定

[TODO: 実装固有の設定詳細を追加してください]

クイックスタート

インストール

Claude Desktop

MacOS の場合：~/Library/Application\ Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

開発版／未公開サーバーの設定

``` "mcpServers": { "req-refine": { "command": "uv", "args": [ "--directory", "D:\code\mcp-server-req-refine", "run", "req-refine" ] } } ```

公開済みサーバーの設定

``` "mcpServers": { "req-refine": { "command": "uvx", "args": [ "req-refine" ] } } ```

開発

ビルドと公開

配布用パッケージを準備するには：

1. 依存関係を同期し、ロックファイルを更新します：

uv sync

2. パッケージの配布物をビルドします：

uv build

これにより、dist/ ディレクトリにソース配布物と wheel 配布物が作成されます。

3. PyPI に公開します：

uv publish

注：環境変数またはコマンドフラグを使用して PyPI の認証情報を設定する必要があります。

• トークン：--token または UV_PUBLISH_TOKEN
• またはユーザー名／パスワード：--username／UV_PUBLISH_USERNAME および --password／UV_PUBLISH_PASSWORD

デバッグ

MCP サーバーは stdio 経由で実行されるため、デバッグが難しい場合があります。最適なデバッグ環境を利用するには、MCP Inspector の使用を強くおすすめします。

次のコマンドを使い、npm 経由で MCP Inspector を起動できます。

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

起動すると、Inspector に URL が表示されます。その URL にブラウザーからアクセスして、デバッグを開始できます。