mcp-test-timebox 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +68 -91
  2. package/dist/server.js +5 -8
  3. package/dist/server.js.map +1 -1
  4. package/package.json +1 -1
package/README.md CHANGED
@@ -1,8 +1,10 @@
1
1
  # mcp-test-timebox
2
2
 
3
+ [![npm version](https://badge.fury.io/js/mcp-test-timebox.svg)](https://www.npmjs.com/package/mcp-test-timebox)
4
+
3
5
  テスト実行の「終わらない／戻ってこない」問題を防ぐ、タイムボックス付きテスト専用MCPサーバ。
4
6
 
5
- ## 概要
7
+ ## 特徴
6
8
 
7
9
  - **必ず結果を返す**: ハードタイムアウト・無出力タイムアウトにより、ハングしても必ずレスポンスを返却
8
10
  - **安全な実行**: 任意コマンド実行を禁止し、固定テンプレート（`flutter test`等）のみ許可
@@ -10,38 +12,67 @@
10
12
 
11
13
  ## インストール
12
14
 
13
- ### 前提条件
15
+ ### npx で直接使用（推奨）
14
16
 
15
- - Node.js 18.0.0 以上
16
- - npm または yarn
17
+ インストール不要で、MCP設定に追加するだけで使えます。
17
18
 
18
- ### インストール手順
19
+ ### ローカルインストール
19
20
 
20
21
  ```bash
21
- # リポジトリをクローン
22
- git clone <repository-url>
23
- cd mcp-test-timebox
22
+ npm install -g mcp-test-timebox
23
+ ```
24
24
 
25
- # 依存関係をインストール
26
- npm install
25
+ ## MCP設定
27
26
 
28
- # ビルド
29
- npm run build
27
+ ### Kiro
28
+
29
+ `.kiro/settings/mcp.json` または `~/.kiro/settings/mcp.json`:
30
+
31
+ ```json
32
+ {
33
+ "mcpServers": {
34
+ "mcp-test-timebox": {
35
+ "command": "npx",
36
+ "args": ["-y", "mcp-test-timebox"],
37
+ "disabled": false
38
+ }
39
+ }
40
+ }
30
41
  ```
31
42
 
32
- ## 使用方法
43
+ ### Claude Desktop
33
44
 
34
- ### MCPサーバとして起動
45
+ `claude_desktop_config.json`:
35
46
 
36
- ```bash
37
- # stdio経由でMCPサーバを起動
38
- npm run start
47
+ ```json
48
+ {
49
+ "mcpServers": {
50
+ "mcp-test-timebox": {
51
+ "command": "npx",
52
+ "args": ["-y", "mcp-test-timebox"]
53
+ }
54
+ }
55
+ }
56
+ ```
57
+
58
+ ### VS Code (Copilot)
59
+
60
+ `.vscode/mcp.json`:
39
61
 
40
- # または直接実行
41
- node dist/server.js
62
+ ```json
63
+ {
64
+ "servers": {
65
+ "mcp-test-timebox": {
66
+ "command": "npx",
67
+ "args": ["-y", "mcp-test-timebox"]
68
+ }
69
+ }
70
+ }
42
71
  ```
43
72
 
44
- ### run_test ツールのパラメータ
73
+ ## 使用方法
74
+
75
+ ### run_test ツール
45
76
 
46
77
  | パラメータ | 型 | 必須 | 説明 |
47
78
  |-----------|-----|------|------|
@@ -55,6 +86,7 @@ node dist/server.js
55
86
 
56
87
  ### 実行例
57
88
 
89
+ 全テスト実行:
58
90
  ```json
59
91
  {
60
92
  "runner": "flutter",
@@ -65,6 +97,7 @@ node dist/server.js
65
97
  }
66
98
  ```
67
99
 
100
+ 特定ファイルのテスト:
68
101
  ```json
69
102
  {
70
103
  "runner": "flutter",
@@ -103,90 +136,34 @@ node dist/server.js
103
136
  | `no_output` | 無出力タイムアウト超過 |
104
137
  | `error` | バリデーションエラー等 |
105
138
 
106
- ## MCP設定例
107
-
108
- ### Kiro での設定
109
-
110
- `.kiro/settings/mcp.json`:
111
-
112
- ```json
113
- {
114
- "mcpServers": {
115
- "mcp-test-timebox": {
116
- "command": "node",
117
- "args": ["/path/to/mcp-test-timebox/dist/server.js"],
118
- "disabled": false,
119
- "autoApprove": []
120
- }
121
- }
122
- }
123
- ```
124
-
125
- ### Claude Desktop での設定
126
-
127
- `claude_desktop_config.json`:
128
-
129
- ```json
130
- {
131
- "mcpServers": {
132
- "mcp-test-timebox": {
133
- "command": "node",
134
- "args": ["/path/to/mcp-test-timebox/dist/server.js"]
135
- }
136
- }
137
- }
138
- ```
139
-
140
- ## 開発
141
-
142
- ### ビルド
143
-
144
- ```bash
145
- npm run build
146
- ```
147
-
148
- ### テスト実行
149
-
150
- ```bash
151
- # 全テスト実行
152
- npm run test
153
-
154
- # ウォッチモード
155
- npm run test:watch
156
-
157
- # カバレッジ付き
158
- npm run test:coverage
159
- ```
160
-
161
- ### 開発モード（ウォッチビルド）
162
-
163
- ```bash
164
- npm run dev
165
- ```
166
-
167
139
  ## 成果物
168
140
 
169
141
  テスト実行ごとに以下のファイルが生成されます：
170
142
 
171
143
  ```
172
144
  .cache/mcp-test-timebox/reports/<timestamp>/
173
- ├── raw.log # stdout/stderrの完全ログ（出力元を区別）
145
+ ├── raw.log # stdout/stderrの完全ログ
174
146
  ├── summary.md # 人間が読みやすい要約
175
147
  └── summary.json # 機械処理用の構造化データ
176
148
  ```
177
149
 
178
- ### raw.log フォーマット
150
+ ## 開発
179
151
 
180
- ```
181
- [2026-01-13T12:34:56.789Z] [stdout] Running "flutter test"...
182
- [2026-01-13T12:34:57.123Z] [stderr] Warning: some warning
183
- [2026-01-13T12:34:58.456Z] [stdout] ✓ Test passed
184
- ```
152
+ ```bash
153
+ # クローン
154
+ git clone https://github.com/kawanishi0117/mcp-test-timebox.git
155
+ cd mcp-test-timebox
185
156
 
186
- ## ドキュメント
157
+ # 依存関係インストール
158
+ npm install
187
159
 
188
- - [MVP要件](docs/MVP.md) - プロジェクトのMVP仕様
160
+ # ビルド
161
+ npm run build
162
+
163
+ # テスト
164
+ npm test
165
+ ```
189
166
 
190
167
  ## ライセンス
191
168
 
192
- MIT License - 詳細は [LICENSE](LICENSE) を参照
169
+ MIT
package/dist/server.js CHANGED
@@ -139,12 +139,9 @@ export async function startServer() {
139
139
  }
140
140
  // メインエントリポイント
141
141
  // このファイルが直接実行された場合にサーバを起動
142
- // ESMではimport.meta.urlを使用してメインモジュールかどうかを判定
143
- const isMainModule = import.meta.url === `file://${process.argv[1]}`;
144
- if (isMainModule) {
145
- startServer().catch((error) => {
146
- console.error('Fatal error:', error);
147
- process.exit(1);
148
- });
149
- }
142
+ // 常にサーバを起動する（CLIツールとして使用されるため）
143
+ startServer().catch((error) => {
144
+ console.error('Fatal error:', error);
145
+ process.exit(1);
146
+ });
150
147
  //# sourceMappingURL=server.js.map
package/dist/server.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mcp-test-timebox",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "description": "タイムボックス付きテスト専用MCPサーバ - テスト実行が終わらない問題を防ぐ",
5
5
  "type": "module",
6
6
  "main": "dist/server.js",