@shuji-bonji/rfcxml-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2025 shuji-bonji
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,190 @@
+# RFCXML MCP Server
+
+RFC 文書を **構造的に理解** するための MCP サーバー。
+
+## 目的
+
+既存の RFC MCP サーバー（テキストベース）と異なり、RFCXML の意味構造を活用して：
+
+- **規範性要件（MUST/SHOULD/MAY）** の抽出・構造化
+- **RFC 間依存関係グラフ** の構築
+- **定義語のスコープ管理**
+- **実装チェックリストの自動生成**
+
+を可能にする。
+
+## レイヤー構造
+
+```
+┌─────────────────────────┐
+│  Markdown / PDF         │  表示・共有
+├─────────────────────────┤
+│  翻訳                   │  説明・検証・普及
+├─────────────────────────┤
+│  RFCXML MCP             │  AI と人の共通理解基盤
+├─────────────────────────┤
+│  RFCXML                 │  唯一の真実（Single Source of Truth）
+└─────────────────────────┘
+```
+
+## 既存 MCP との違い
+
+| 機能 | 既存 mcp-rfc | RFCXML MCP |
+|------|-------------|------------|
+| RFC テキスト取得 | ✅ | ✅ |
+| セクション抽出 | ✅ (テキストベース) | ✅ (構造ベース) |
+| MUST/SHOULD/MAY 抽出 | ❌ | ✅ |
+| 条件・例外の構造化 | ❌ | ✅ |
+| RFC 間依存グラフ | ❌ | ✅ |
+| 定義スコープ管理 | ❌ | ✅ |
+| 実装チェックリスト | ❌ | ✅ |
+
+## インストール
+
+```bash
+npm install @shuji-bonji/rfcxml-mcp
+```
+
+## MCP 設定
+
+```json
+{
+  "mcpServers": {
+    "rfcxml": {
+      "command": "npx",
+      "args": ["-y", "@shuji-bonji/rfcxml-mcp"]
+    }
+  }
+}
+```
+
+## 利用可能なツール
+
+### Phase 1: 基本構造
+
+- `get_rfc_structure` - セクション階層とメタデータ取得
+- `get_requirements` - 規範性要件（MUST/SHOULD/MAY）の構造化抽出
+- `get_definitions` - 用語定義とスコープ
+
+### Phase 2: 関係性
+
+- `get_rfc_dependencies` - 参照 RFC（normative/informative）
+- `get_related_sections` - 関連セクション（同一 RFC 内）
+
+### Phase 3: 検証支援
+
+- `validate_statement` - 主張が RFC に準拠しているか検証
+- `generate_checklist` - 実装チェックリスト生成
+
+## 古い RFC のサポート
+
+RFC 8650 (2019年12月) 以降は公式 RFCXML v3 形式で提供されていますが、それ以前の RFC は XML が利用できない場合があります。
+
+このサーバーは **自動フォールバック機能** を備えており、XML が取得できない場合はテキスト形式から解析を行います。
+
+### ソース情報
+
+すべてのレスポンスには解析ソース情報が含まれます：
+
+```json
+{
+  "rfc": 6455,
+  "sections": [...],
+  "_source": "text",
+  "_sourceNote": "⚠️ テキストからの解析結果です。精度が低い可能性があります。"
+}
+```
+
+| `_source` | 説明 |
+|-----------|------|
+| `xml` | RFCXML から解析（高精度） |
+| `text` | テキストから解析（中精度） |
+
+### 対応状況
+
+| RFC | 形式 | 備考 |
+|-----|------|------|
+| RFC 8650 以降 | XML | RFCXML v3 公式対応 |
+| RFC 8650 未満 | テキスト | 自動フォールバック |
+
+## 使用例
+
+### 規範性要件の抽出
+
+```typescript
+// ツール呼び出し
+{
+  "tool": "get_requirements",
+  "arguments": {
+    "rfc": 6455,
+    "section": "5.5.1"
+  }
+}
+
+// 結果
+{
+  "section": "5.5.1",
+  "title": "Close",
+  "requirements": [
+    {
+      "id": "R-5.5.1-1",
+      "level": "MUST",
+      "text": "endpoint MUST send a Close frame",
+      "subject": "endpoint",
+      "action": "send Close frame",
+      "condition": "when closing connection",
+      "fullContext": "After sending a control frame indicating..."
+    }
+  ]
+}
+```
+
+### 実装チェックリスト生成
+
+```typescript
+// ツール呼び出し
+{
+  "tool": "generate_checklist",
+  "arguments": {
+    "rfc": 6455,
+    "role": "client"
+  }
+}
+
+// 結果（Markdown）
+## RFC 6455 WebSocket Client 実装チェックリスト
+
+### 必須要件 (MUST)
+- [ ] Opening Handshake で Sec-WebSocket-Key を含める (Section 4.1)
+- [ ] Close フレーム受信後、TCP 接続を閉じる (Section 5.5.1)
+- [ ] マスクキーは予測不可能である必要がある (Section 5.3)
+
+### 推奨要件 (SHOULD)
+- [ ] Close フレームには理由を含める (Section 7.1.6)
+```
+
+## 開発
+
+```bash
+# 依存関係インストール
+npm install
+
+# 開発モード
+npm run dev
+
+# ビルド
+npm run build
+
+# テスト
+npm test
+```
+
+## ライセンス
+
+MIT
+
+## 関連プロジェクト
+
+- [mjpitz/mcp-rfc](https://github.com/mjpitz/mcp-rfc) - テキストベースの RFC MCP
+- [ietf-tools/RFCXML](https://github.com/ietf-tools/RFCXML) - RFCXML スキーマ
+- [xml2rfc](https://xml2rfc.ietf.org/) - IETF 公式ツール

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * RFCXML MCP Server
+ * RFC 文書を構造的に理解するための MCP サーバー
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+/**
+ * RFCXML MCP Server
+ * RFC 文書を構造的に理解するための MCP サーバー
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { tools } from './tools/definitions.js';
+import { handleGetRFCStructure, handleGetRequirements, handleGetDefinitions, handleGetDependencies, handleGetRelatedSections, handleGenerateChecklist, handleValidateStatement, } from './tools/handlers.js';
+// サーバーインスタンス
+const server = new Server({
+    name: 'rfcxml-mcp',
+    version: '0.1.0',
+}, {
+    capabilities: {
+        tools: {},
+        resources: {},
+    },
+});
+// ツール一覧
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return { tools };
+});
+// ツール実行
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        let result;
+        switch (name) {
+            case 'get_rfc_structure':
+                result = await handleGetRFCStructure(args);
+                break;
+            case 'get_requirements':
+                result = await handleGetRequirements(args);
+                break;
+            case 'get_definitions':
+                result = await handleGetDefinitions(args);
+                break;
+            case 'get_rfc_dependencies':
+                result = await handleGetDependencies(args);
+                break;
+            case 'get_related_sections':
+                result = await handleGetRelatedSections(args);
+                break;
+            case 'generate_checklist':
+                result = await handleGenerateChecklist(args);
+                break;
+            case 'validate_statement':
+                result = await handleValidateStatement(args);
+                break;
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: message }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// リソース一覧（RFC スキーマ）
+server.setRequestHandler(ListResourcesRequestSchema, async () => {
+    return {
+        resources: [
+            {
+                uri: 'rfcxml://schema',
+                name: 'RFCXML Schema Information',
+                description: 'RFCXML v3 の構造とスキーマ情報',
+                mimeType: 'application/json',
+            },
+        ],
+    };
+});
+// リソース読み取り
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const { uri } = request.params;
+    if (uri === 'rfcxml://schema') {
+        return {
+            contents: [
+                {
+                    uri,
+                    mimeType: 'application/json',
+                    text: JSON.stringify({
+                        version: 'v3',
+                        spec: 'RFC 7991 (superseded by rfc7991bis)',
+                        documentation: 'https://authors.ietf.org/rfcxml-vocabulary',
+                        keyElements: {
+                            bcp14: 'RFC 2119 キーワード（MUST, SHOULD, MAY 等）をマークアップ',
+                            xref: '内部・外部参照',
+                            reference: '参考文献',
+                            section: 'セクション構造',
+                            t: 'テキストパラグラフ',
+                            dl: '定義リスト',
+                            sourcecode: 'ソースコード',
+                        },
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    throw new Error(`Unknown resource: ${uri}`);
+});
+// サーバー起動
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('RFCXML MCP Server started');
+}
+main().catch((error) => {
+    console.error('Server error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/services/rfc-fetcher.d.ts

@@ -0,0 +1,36 @@
+/**
+ * RFC 取得サービス
+ * RFCXML ソースの取得とキャッシュ管理
+ */
+import type { RFCMetadata } from '../types/index.js';
+/**
+ * RFCXML を取得
+ */
+export declare function fetchRFCXML(rfcNumber: number): Promise<string>;
+/**
+ * RFC メタデータを取得（IETF Datatracker API）
+ */
+export declare function fetchRFCMetadata(rfcNumber: number): Promise<RFCMetadata>;
+/**
+ * RFC テキストを取得
+ */
+export declare function fetchRFCText(rfcNumber: number): Promise<string>;
+/**
+ * RFC が XML 形式で利用可能か確認
+ * 注: RFC 8650 (2019年12月) 以降は公式に RFCXML v3
+ */
+export declare function isRFCXMLAvailable(rfcNumber: number): boolean;
+/**
+ * RFC XML 取得エラー
+ */
+export declare class RFCXMLNotAvailableError extends Error {
+    readonly rfcNumber: number;
+    readonly isOldRFC: boolean;
+    readonly suggestion: string;
+    constructor(rfcNumber: number, originalErrors?: string[]);
+}
+/**
+ * キャッシュクリア
+ */
+export declare function clearCache(): void;
+//# sourceMappingURL=rfc-fetcher.d.ts.map

package/dist/services/rfc-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rfc-fetcher.d.ts","sourceRoot":"","sources":["../../src/services/rfc-fetcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA6BrD;;GAEG;AACH,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwCpE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAoD9E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwCrE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAI5D;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,QAAQ,EAAE,OAAO,CAAC;IAClC,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,SAAS,EAAE,MAAM,EAAE,cAAc,GAAE,MAAM,EAAO;CAmB7D;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAIjC"}

package/dist/services/rfc-fetcher.js

@@ -0,0 +1,220 @@
+/**
+ * RFC 取得サービス
+ * RFCXML ソースの取得とキャッシュ管理
+ */
+// キャッシュ（メモリ内）
+const xmlCache = new Map();
+const textCache = new Map();
+const metadataCache = new Map();
+/**
+ * RFC XML ソースの取得元
+ */
+const RFC_XML_SOURCES = {
+    // RFC Editor 公式
+    rfcEditor: (num) => `https://www.rfc-editor.org/rfc/rfc${num}.xml`,
+    // IETF Tools
+    ietfTools: (num) => `https://xml2rfc.ietf.org/public/rfc/rfc${num}.xml`,
+    // Datatracker
+    datatracker: (num) => `https://datatracker.ietf.org/doc/rfc${num}/xml/`,
+};
+/**
+ * RFC テキストソースの取得元
+ */
+const RFC_TEXT_SOURCES = {
+    // RFC Editor 公式（テキスト）
+    rfcEditor: (num) => `https://www.rfc-editor.org/rfc/rfc${num}.txt`,
+    // IETF Tools
+    ietfTools: (num) => `https://tools.ietf.org/rfc/rfc${num}.txt`,
+};
+/**
+ * RFCXML を取得
+ */
+export async function fetchRFCXML(rfcNumber) {
+    // キャッシュチェック
+    const cached = xmlCache.get(rfcNumber);
+    if (cached) {
+        return cached;
+    }
+    // 複数ソースを試行
+    const errors = [];
+    for (const [sourceName, urlFn] of Object.entries(RFC_XML_SOURCES)) {
+        try {
+            const url = urlFn(rfcNumber);
+            const response = await fetch(url, {
+                headers: {
+                    Accept: 'application/xml, text/xml',
+                    'User-Agent': 'rfcxml-mcp/0.1.0',
+                },
+            });
+            if (response.ok) {
+                const xml = await response.text();
+                // 基本的な XML 検証
+                if (xml.includes('<?xml') || xml.includes('<rfc')) {
+                    xmlCache.set(rfcNumber, xml);
+                    console.error(`[RFC ${rfcNumber}] Fetched from ${sourceName}`);
+                    return xml;
+                }
+            }
+        }
+        catch (error) {
+            errors.push(error);
+        }
+    }
+    // すべて失敗した場合
+    throw new RFCXMLNotAvailableError(rfcNumber, errors.map((e) => e.message));
+}
+/**
+ * RFC メタデータを取得（IETF Datatracker API）
+ */
+export async function fetchRFCMetadata(rfcNumber) {
+    // キャッシュチェック
+    const cached = metadataCache.get(rfcNumber);
+    if (cached) {
+        return cached;
+    }
+    const url = `https://datatracker.ietf.org/api/v1/doc/document/rfc${rfcNumber}/`;
+    try {
+        const response = await fetch(url, {
+            headers: {
+                Accept: 'application/json',
+                'User-Agent': 'rfcxml-mcp/0.1.0',
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}`);
+        }
+        const data = (await response.json());
+        const metadata = {
+            number: rfcNumber,
+            title: data.title || `RFC ${rfcNumber}`,
+            authors: [], // TODO: 別 API から取得
+            date: data.time || '',
+            category: mapCategory(data.std_level ?? null),
+            stream: mapStream(data.stream ?? null),
+            abstract: data.abstract || undefined,
+        };
+        metadataCache.set(rfcNumber, metadata);
+        return metadata;
+    }
+    catch (_error) {
+        // フォールバック: 最小限のメタデータ
+        return {
+            number: rfcNumber,
+            title: `RFC ${rfcNumber}`,
+            authors: [],
+            date: '',
+            category: 'info',
+            stream: 'IETF',
+        };
+    }
+}
+/**
+ * RFC テキストを取得
+ */
+export async function fetchRFCText(rfcNumber) {
+    // キャッシュチェック
+    const cached = textCache.get(rfcNumber);
+    if (cached) {
+        return cached;
+    }
+    // 複数ソースを試行
+    const errors = [];
+    for (const [sourceName, urlFn] of Object.entries(RFC_TEXT_SOURCES)) {
+        try {
+            const url = urlFn(rfcNumber);
+            const response = await fetch(url, {
+                headers: {
+                    Accept: 'text/plain',
+                    'User-Agent': 'rfcxml-mcp/0.1.0',
+                },
+            });
+            if (response.ok) {
+                const text = await response.text();
+                // 基本的な検証（RFCテキストの特徴を確認）
+                if (text.includes('Request for Comments') || text.includes('RFC ')) {
+                    textCache.set(rfcNumber, text);
+                    console.error(`[RFC ${rfcNumber}] Text fetched from ${sourceName}`);
+                    return text;
+                }
+            }
+        }
+        catch (error) {
+            errors.push(error);
+        }
+    }
+    // すべて失敗
+    throw new Error(`Failed to fetch RFC ${rfcNumber} text from all sources. ` +
+        `Errors: ${errors.map((e) => e.message).join(', ')}`);
+}
+/**
+ * RFC が XML 形式で利用可能か確認
+ * 注: RFC 8650 (2019年12月) 以降は公式に RFCXML v3
+ */
+export function isRFCXMLAvailable(rfcNumber) {
+    // RFC 8650 以降は確実に RFCXML v3 が利用可能
+    // それ以前は一部のみ利用可能
+    return rfcNumber >= 8650;
+}
+/**
+ * RFC XML 取得エラー
+ */
+export class RFCXMLNotAvailableError extends Error {
+    rfcNumber;
+    isOldRFC;
+    suggestion;
+    constructor(rfcNumber, originalErrors = []) {
+        const isOldRFC = rfcNumber < 8650;
+        const suggestion = isOldRFC
+            ? `RFC ${rfcNumber} は RFCXML v3 より前の形式で公開されているため、XML が利用できない可能性があります。` +
+                `テキスト形式での取得を検討してください（ietf MCP の get_ietf_doc を使用）。`
+            : `RFC ${rfcNumber} の XML 取得に失敗しました。ネットワーク接続を確認してください。`;
+        super(`RFC ${rfcNumber} XML を取得できませんでした。\n` +
+            `理由: ${isOldRFC ? '古い RFC (< 8650) のため XML が利用できない可能性があります' : 'ネットワークエラー'}\n` +
+            `提案: ${suggestion}` +
+            (originalErrors.length > 0 ? `\n詳細: ${originalErrors.join(', ')}` : ''));
+        this.name = 'RFCXMLNotAvailableError';
+        this.rfcNumber = rfcNumber;
+        this.isOldRFC = isOldRFC;
+        this.suggestion = suggestion;
+    }
+}
+/**
+ * キャッシュクリア
+ */
+export function clearCache() {
+    xmlCache.clear();
+    textCache.clear();
+    metadataCache.clear();
+}
+// ヘルパー関数
+function mapCategory(stdLevel) {
+    switch (stdLevel?.toLowerCase()) {
+        case 'proposed standard':
+        case 'draft standard':
+        case 'internet standard':
+            return 'std';
+        case 'best current practice':
+            return 'bcp';
+        case 'experimental':
+            return 'exp';
+        case 'historic':
+            return 'historic';
+        default:
+            return 'info';
+    }
+}
+function mapStream(stream) {
+    switch (stream?.toLowerCase()) {
+        case 'ietf':
+            return 'IETF';
+        case 'iab':
+            return 'IAB';
+        case 'irtf':
+            return 'IRTF';
+        case 'ise':
+            return 'independent';
+        default:
+            return 'IETF';
+    }
+}
+//# sourceMappingURL=rfc-fetcher.js.map

package/dist/services/rfc-fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rfc-fetcher.js","sourceRoot":"","sources":["../../src/services/rfc-fetcher.ts"],"names":[],"mappings":"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"}

package/dist/services/rfc-text-parser.d.ts

@@ -0,0 +1,18 @@
+/**
+ * RFC テキストパーサー
+ * XMLが利用できない古いRFC用のフォールバック解析
+ */
+import type { Section, Requirement, RequirementLevel } from '../types/index.js';
+import type { ParsedRFC } from './rfcxml-parser.js';
+/**
+ * RFC テキストをパースして構造化データに変換（中精度）
+ */
+export declare function parseRFCText(text: string, rfcNumber: number): ParsedRFC;
+/**
+ * テキストから要件を抽出
+ */
+export declare function extractTextRequirements(sections: Section[], filter?: {
+    section?: string;
+    level?: RequirementLevel;
+}): Requirement[];
+//# sourceMappingURL=rfc-text-parser.d.ts.map

package/dist/services/rfc-text-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rfc-text-parser.d.ts","sourceRoot":"","sources":["../../src/services/rfc-text-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,WAAW,EACX,gBAAgB,EAIjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAmBpD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,CAYvE;AAyMD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,gBAAgB,CAAA;CAAE,GACtD,WAAW,EAAE,CA0Cf"}