@shuji-bonji/pdf-spec-mcp 0.2.2 → 0.2.4

package/README.ja.md

@@ -156,14 +156,20 @@ pdf-specs/
 
 ### 2. インストール
 
+このパッケージは MCP クライアントから起動される CLI バイナリ（`pdf-spec-mcp`）を提供します。
+**通常は手動でインストールする必要はありません** — 次のステップのように MCP クライアント側で `npx @shuji-bonji/pdf-spec-mcp` を指定してください。
+
+シェルから直接動作確認したい場合（デバッグ用途など）:
+
 ```bash
-npm install @shuji-bonji/pdf-spec-mcp
+PDF_SPEC_DIR=/path/to/pdf-specs npx -y @shuji-bonji/pdf-spec-mcp
 ```
 
-npx での直接実行も可能です：
+グローバルインストールしたい場合（任意）:
 
 ```bash
-PDF_SPEC_DIR=/path/to/pdf-specs npx @shuji-bonji/pdf-spec-mcp
+npm install -g @shuji-bonji/pdf-spec-mcp
+PDF_SPEC_DIR=/path/to/pdf-specs pdf-spec-mcp
 ```
 
 ### 3. MCP クライアント設定
@@ -389,6 +395,8 @@ src/
 ├── tools/
 │   ├── definitions.ts    # MCP ツールスキーマ
 │   └── handlers.ts       # ツール実装
+├── types/
+│   └── index.ts          # 共有型定義
 └── utils/
     ├── concurrency.ts    # mapConcurrent（制限付き並行 Promise.all）
     ├── text.ts           # テキスト正規化

package/README.md

@@ -156,14 +156,20 @@ pdf-specs/
 
 ### 2. Install
 
+This package ships a CLI binary (`pdf-spec-mcp`) intended to be launched by an MCP client.
+**You do not need to install it manually** — just point your MCP client to `npx @shuji-bonji/pdf-spec-mcp` as shown in the next step.
+
+If you want to run it directly from the shell (e.g. for debugging):
+
 ```bash
-npm install @shuji-bonji/pdf-spec-mcp
+PDF_SPEC_DIR=/path/to/pdf-specs npx -y @shuji-bonji/pdf-spec-mcp
 ```
 
-Or run directly with npx:
+Or install it globally (optional):
 
 ```bash
-PDF_SPEC_DIR=/path/to/pdf-specs npx @shuji-bonji/pdf-spec-mcp
+npm install -g @shuji-bonji/pdf-spec-mcp
+PDF_SPEC_DIR=/path/to/pdf-specs pdf-spec-mcp
 ```
 
 ### 3. Configure MCP Client
@@ -386,6 +392,8 @@ src/
 ├── tools/
 │   ├── definitions.ts    # MCP tool schemas
 │   └── handlers.ts       # Tool implementations
+├── types/
+│   └── index.ts          # Shared type definitions
 └── utils/
     ├── concurrency.ts    # mapConcurrent (bounded Promise.all)
     ├── text.ts           # Text normalization

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shuji-bonji/pdf-spec-mcp",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "MCP server for structured understanding of ISO 32000 (PDF) specifications",
   "keywords": [
     "mcp",
@@ -25,7 +25,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && chmod +x dist/index.js",
     "dev": "tsc --watch",
     "start": "node dist/index.js",
     "test": "vitest run",