@shuji-bonji/rfcxml-mcp 0.4.5 → 0.4.7

package/README.ja.md

@@ -60,7 +60,9 @@ MCP 設定ファイルに以下を追加：
 
 - **Claude Desktop (macOS)**: `~/Library/Application Support/Claude/claude_desktop_config.json`
 - **Claude Desktop (Windows)**: `%APPDATA%\Claude\claude_desktop_config.json`
-- **Claude Code**: `.claude/settings.json` または `claude settings` コマンド
+- **Claude Code (プロジェクトスコープ)**: プロジェクトルートの `.mcp.json`
+- **Claude Code (ユーザースコープ)**: `~/.claude.json`
+- **Claude Code (CLI)**: `claude mcp add rfcxml -- npx -y @shuji-bonji/rfcxml-mcp`
 
 ### インストール（オプション）
 
@@ -68,8 +70,11 @@ MCP 設定ファイルに以下を追加：
 
 ```bash
 npm install -g @shuji-bonji/rfcxml-mcp
+```
+
+MCP 設定：
 
-# MCP 設定
+```json
 {
   "mcpServers": {
     "rfcxml": {
@@ -275,20 +280,27 @@ RFC 9293 (TCP) の実装チェックリストを生成してください。
 src/
 ├── index.ts                    # MCP サーバーエントリポイント
 ├── config.ts                   # 設定の一元管理
-├── constants.ts                # BCP 14 キーワード定義
+├── constants.ts                # BCP 14 キーワード定義 + RFC 番号制限
 ├── services/
 │   ├── rfc-fetcher.ts          # RFC 取得（並列フェッチ）
+│   ├── rfc-service.ts          # RFC パース・キャッシュ管理
 │   ├── rfcxml-parser.ts        # RFCXML パーサー
-│   └── rfc-text-parser.ts      # テキストフォールバック
+│   ├── rfc-text-parser.ts      # テキストフォールバックパーサー
+│   └── checklist-generator.ts  # チェックリスト生成サービス
 ├── tools/
 │   ├── definitions.ts          # MCP ツール定義
-│   └── handlers.ts             # ツールハンドラー
+│   └── handlers.ts             # ツールハンドラー（toolHandlers マップ）
 ├── types/
 │   └── index.ts                # 型定義
 └── utils/
     ├── cache.ts                # LRU キャッシュ
     ├── fetch.ts                # 並列フェッチユーティリティ
-    └── text.ts                 # テキスト処理ユーティリティ
+    ├── logger.ts               # ログ抽象化
+    ├── requirement-extractor.ts # 共通要件抽出
+    ├── section.ts              # セクション検索ユーティリティ
+    ├── statement-matcher.ts    # 重み付きマッチング
+    ├── text.ts                 # テキスト処理ユーティリティ
+    └── validation.ts           # 入力バリデーション
 ```
 
 ### RFC 取得の最適化
@@ -339,9 +351,15 @@ npm run dev
 # ビルド
 npm run build
 
-# テスト
+# テスト（ウォッチモード）
 npm test
 
+# テスト（単発実行 — CI 等で使用）
+npm test -- --run
+
+# E2E テスト（MCP クライアント統合）
+npm run test:e2e
+
 # リント
 npm run lint
 

package/README.md

@@ -66,7 +66,9 @@ Configuration file locations:
 
 - **Claude Desktop (macOS)**: `~/Library/Application Support/Claude/claude_desktop_config.json`
 - **Claude Desktop (Windows)**: `%APPDATA%\Claude\claude_desktop_config.json`
-- **Claude Code**: `.claude/settings.json` or use `claude settings` command
+- **Claude Code (project scope)**: `.mcp.json` at the project root
+- **Claude Code (user scope)**: `~/.claude.json`
+- **Claude Code (CLI)**: `claude mcp add rfcxml -- npx -y @shuji-bonji/rfcxml-mcp`
 
 ### Installation (Optional)
 
@@ -74,8 +76,11 @@ For global installation:
 
 ```bash
 npm install -g @shuji-bonji/rfcxml-mcp
+```
+
+Then configure MCP:
 
-# MCP configuration
+```json
 {
   "mcpServers": {
     "rfcxml": {
@@ -118,7 +123,7 @@ All responses include source information:
   "rfc": 6455,
   "sections": [...],
   "_source": "text",
-  "_sourceNote": "⚠️ Parsed from text format. Accuracy may be lower."
+  "_sourceNote": "Warning: Parsed from text format. Accuracy may be limited."
 }
 ```
 
@@ -249,7 +254,7 @@ Role: Client
     { "number": "5", "title": "Data Framing" }
   ],
   "_source": "text",
-  "_sourceNote": "⚠️ Parsed from text format. Accuracy may be lower."
+  "_sourceNote": "Warning: Parsed from text format. Accuracy may be limited."
 }
 ```
 
@@ -277,22 +282,25 @@ Generate an implementation checklist for RFC 9293 (TCP).
 src/
 ├── index.ts                    # MCP server entry point
 ├── config.ts                   # Centralized configuration
-├── constants.ts                # BCP 14 keyword definitions
+├── constants.ts                # BCP 14 keyword definitions + RFC number limits
 ├── services/
 │   ├── rfc-fetcher.ts          # RFC fetching (parallel)
+│   ├── rfc-service.ts          # RFC parse & cache management
 │   ├── rfcxml-parser.ts        # RFCXML parser
 │   ├── rfc-text-parser.ts      # Text fallback parser
 │   └── checklist-generator.ts  # Checklist generation service
 ├── tools/
 │   ├── definitions.ts          # MCP tool definitions
-│   └── handlers.ts             # Tool handlers
+│   └── handlers.ts             # Tool handlers (toolHandlers map)
 ├── types/
 │   └── index.ts                # Type definitions
 └── utils/
     ├── cache.ts                # LRU cache
     ├── fetch.ts                # Parallel fetch utility
+    ├── logger.ts               # Logger abstraction
     ├── requirement-extractor.ts # Shared requirement extraction
     ├── section.ts              # Section search utilities
+    ├── statement-matcher.ts    # Weighted statement matching
     ├── text.ts                 # Text processing utility
     └── validation.ts           # Input validation
 ```
@@ -345,9 +353,15 @@ npm run dev
 # Build
 npm run build
 
-# Test
+# Test (watch mode)
 npm test
 
+# Test (single run — for CI etc.)
+npm test -- --run
+
+# E2E test (MCP client integration)
+npm run test:e2e
+
 # Lint
 npm run lint
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shuji-bonji/rfcxml-mcp",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "description": "MCP server for structured understanding of RFC documents via RFCXML",
   "keywords": [
     "mcp",
@@ -30,6 +30,7 @@
     "dev": "tsc --watch",
     "start": "node dist/index.js",
     "test": "vitest",
+    "test:e2e": "node tests/e2e/mcp-client-test.mjs",
     "lint": "eslint src",
     "format": "prettier --write src",
     "format:check": "prettier --check src",