codex-skills-mcp 1.0.6 → 1.1.0
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.
- package/README.md +155 -82
- package/dist/config.d.ts +8 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +6 -2
- package/dist/config.js.map +1 -1
- package/dist/index.d.ts +3 -3
- package/dist/index.js +42 -18
- package/dist/index.js.map +1 -1
- package/dist/loader/index.d.ts +3 -0
- package/dist/loader/index.d.ts.map +1 -1
- package/dist/loader/index.js +12 -4
- package/dist/loader/index.js.map +1 -1
- package/dist/remote/github.d.ts +2 -1
- package/dist/remote/github.d.ts.map +1 -1
- package/dist/remote/github.js +59 -7
- package/dist/remote/github.js.map +1 -1
- package/dist/search/index.d.ts +21 -19
- package/dist/search/index.d.ts.map +1 -1
- package/dist/search/index.js +419 -77
- package/dist/search/index.js.map +1 -1
- package/dist/tools/plan-workflow.js +2 -2
- package/dist/tools/plan-workflow.js.map +1 -1
- package/dist/tools/read-skill.d.ts.map +1 -1
- package/dist/tools/read-skill.js +4 -0
- package/dist/tools/read-skill.js.map +1 -1
- package/dist/tools/search-skills.d.ts.map +1 -1
- package/dist/tools/search-skills.js +6 -1
- package/dist/tools/search-skills.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,80 +1,98 @@
|
|
|
1
1
|
# codex-skills-mcp
|
|
2
2
|
|
|
3
|
-
> 🧠 Codex-Skills 技能库的 MCP (Model Context Protocol) Server — 让任意 AI 编程工具都能检索、阅读和使用
|
|
3
|
+
> 🧠 Codex-Skills 技能库的 MCP (Model Context Protocol) Server — 让任意 AI 编程工具都能检索、阅读和使用 180+ 专业技能。
|
|
4
4
|
|
|
5
5
|
## 这是什么
|
|
6
6
|
|
|
7
7
|
一个独立的 MCP Server，为 [codex-skills](https://github.com/Zhan-ZhangZ/codex-skills) 技能库提供标准化的 AI 工具接入协议。
|
|
8
8
|
|
|
9
|
+
- **无需先下载全部技能文件**：启动只拉取轻量清单（约 108KB），技能全文按需加载；
|
|
10
|
+
- **180+ 技能、14 个分类**：技能库由专家在远端持续维护，用户端零操作；
|
|
11
|
+
- **内置国内网络加速**：自动回退链，国内网络免翻墙可用。
|
|
12
|
+
|
|
9
13
|
| 特性 | 说明 |
|
|
10
14
|
|------|------|
|
|
11
15
|
| **6 个 MCP Tools** | search_skills, read_skill, load_skill_file, list_skill_files, list_categories, plan_workflow |
|
|
12
16
|
| **三层渐进加载** | 检索(~500 tokens) → 阅读(~5K tokens) → 深入(按需) |
|
|
13
17
|
| **中文搜索优化** | CJK bigram 分词 + Leading Words 权重 |
|
|
14
18
|
| **零外部 AI 依赖** | 纯关键词搜索，不需要 embedding 模型 |
|
|
15
|
-
| **双传输模式** | stdio（本地）+ HTTP
|
|
19
|
+
| **双传输模式** | stdio（本地）+ HTTP（远程） |
|
|
20
|
+
| **自动网络加速** | GitHub 直连 → jsDelivr → gh-proxy.com → ghfast.top 四级回退 |
|
|
21
|
+
| **增量缓存** | 技能文件按大小比对断点续传，重复使用不重复下载 |
|
|
16
22
|
|
|
17
23
|
## 快速开始
|
|
18
24
|
|
|
19
|
-
### 1.
|
|
25
|
+
### 1. 远程模式（默认，零配置，推荐）
|
|
20
26
|
|
|
21
27
|
```bash
|
|
22
|
-
|
|
23
|
-
npm install
|
|
24
|
-
npm run build
|
|
28
|
+
npx -y codex-skills-mcp@latest
|
|
25
29
|
```
|
|
26
30
|
|
|
27
|
-
|
|
31
|
+
无需安装、无需指定任何路径。启动后自动完成：
|
|
28
32
|
|
|
29
|
-
|
|
33
|
+
1. 从远端技能库拉取清单 `skills_manifest.json`（约 108KB，仅首次）；
|
|
34
|
+
2. 建立本地搜索索引（毫秒级）；
|
|
35
|
+
3. 技能文件按需下载，缓存在当前目录 `.codex-skills-cache/`。
|
|
30
36
|
|
|
31
|
-
|
|
37
|
+
### 2. 本地模式（可选）
|
|
32
38
|
|
|
33
|
-
|
|
39
|
+
适用于离线开发或使用本地技能库副本：
|
|
34
40
|
|
|
35
|
-
|
|
41
|
+
```bash
|
|
42
|
+
cd codex-skills-mcp
|
|
43
|
+
npm install
|
|
44
|
+
npm run build
|
|
45
|
+
node dist/index.js --skills-dir /path/to/codex-skills
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
### 3. HTTP 模式（远程客户端）
|
|
36
49
|
|
|
37
50
|
```bash
|
|
51
|
+
# 远程模式：无需 --skills-dir，自动拉取远端技能库
|
|
52
|
+
node dist/index.js --http --port 3456
|
|
53
|
+
|
|
54
|
+
# 本地模式：加 --skills-dir 指定本地技能库
|
|
38
55
|
node dist/index.js --skills-dir /path/to/codex-skills --http --port 3456
|
|
39
56
|
```
|
|
40
57
|
|
|
41
|
-
|
|
42
|
-
```
|
|
43
|
-
[codex-skills-mcp] HTTP server running at http://localhost:3456/mcp
|
|
44
|
-
[codex-skills-mcp] Health check: http://localhost:3456/health
|
|
45
|
-
```
|
|
58
|
+
启动后：
|
|
46
59
|
|
|
47
|
-
|
|
60
|
+
- MCP 端点：`http://localhost:3456/mcp`（POST / GET / DELETE，支持 `mcp-session-id` 会话管理）
|
|
61
|
+
- 健康检查：`http://localhost:3456/health`
|
|
48
62
|
|
|
49
63
|
```bash
|
|
50
|
-
|
|
64
|
+
curl http://localhost:3456/health
|
|
65
|
+
# 预期输出
|
|
66
|
+
{"status":"ok","name":"codex-skills-mcp","version":"1.0.6","skills":181}
|
|
51
67
|
```
|
|
52
68
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
**Step 3：在 ChatGPT 桌面端添加 MCP Server**
|
|
69
|
+
## 客户端配置
|
|
56
70
|
|
|
57
|
-
|
|
58
|
-
2. 找到 **MCP Servers** / **Apps** 区域
|
|
59
|
-
3. 点击 **Add Server**
|
|
60
|
-
4. 填入 URL：`https://xxxx-xxxx.ngrok-free.app/mcp`
|
|
61
|
-
5. 保存，完成
|
|
71
|
+
### Codex / ChatGPT 桌面端（stdio）
|
|
62
72
|
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
**验证是否正常运行：**
|
|
73
|
+
**方式一：通过 CLI 快速添加（推荐）**
|
|
66
74
|
|
|
67
75
|
```bash
|
|
68
|
-
|
|
69
|
-
|
|
76
|
+
codex mcp add codex-skills -- npx -y codex-skills-mcp@latest
|
|
77
|
+
```
|
|
70
78
|
|
|
71
|
-
|
|
72
|
-
|
|
79
|
+
**方式二：编辑 `~/.codex/config.toml` 添加**
|
|
80
|
+
|
|
81
|
+
```toml
|
|
82
|
+
[mcp_servers.codex-skills]
|
|
83
|
+
command = "npx"
|
|
84
|
+
args = ["-y", "codex-skills-mcp@latest"]
|
|
73
85
|
```
|
|
74
86
|
|
|
75
|
-
|
|
87
|
+
若使用本地技能库副本，可改为：
|
|
76
88
|
|
|
77
|
-
|
|
89
|
+
```toml
|
|
90
|
+
[mcp_servers.codex-skills]
|
|
91
|
+
command = "node"
|
|
92
|
+
args = ["/path/to/codex-skills-mcp/dist/index.js", "--skills-dir", "/path/to/codex-skills"]
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
### Claude Desktop
|
|
78
96
|
|
|
79
97
|
编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`：
|
|
80
98
|
|
|
@@ -82,20 +100,14 @@ curl http://localhost:3456/health
|
|
|
82
100
|
{
|
|
83
101
|
"mcpServers": {
|
|
84
102
|
"codex-skills": {
|
|
85
|
-
"command": "
|
|
86
|
-
"args": [
|
|
87
|
-
"/path/to/codex-skills-mcp/dist/index.js",
|
|
88
|
-
"--skills-dir",
|
|
89
|
-
"/path/to/codex-skills"
|
|
90
|
-
]
|
|
103
|
+
"command": "npx",
|
|
104
|
+
"args": ["-y", "codex-skills-mcp@latest"]
|
|
91
105
|
}
|
|
92
106
|
}
|
|
93
107
|
}
|
|
94
108
|
```
|
|
95
109
|
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
#### Cursor
|
|
110
|
+
### Cursor
|
|
99
111
|
|
|
100
112
|
编辑项目根目录 `.cursor/mcp.json`：
|
|
101
113
|
|
|
@@ -103,63 +115,98 @@ curl http://localhost:3456/health
|
|
|
103
115
|
{
|
|
104
116
|
"mcpServers": {
|
|
105
117
|
"codex-skills": {
|
|
106
|
-
"command": "
|
|
107
|
-
"args": [
|
|
108
|
-
"/path/to/codex-skills-mcp/dist/index.js",
|
|
109
|
-
"--skills-dir",
|
|
110
|
-
"/path/to/codex-skills"
|
|
111
|
-
]
|
|
118
|
+
"command": "npx",
|
|
119
|
+
"args": ["-y", "codex-skills-mcp@latest"]
|
|
112
120
|
}
|
|
113
121
|
}
|
|
114
122
|
}
|
|
115
123
|
```
|
|
116
124
|
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
#### Windsurf / VS Code + Copilot
|
|
125
|
+
### Windsurf / VS Code + Copilot
|
|
120
126
|
|
|
121
127
|
在 MCP 配置中添加同样的 command + args（stdio 模式）。
|
|
122
128
|
|
|
123
|
-
|
|
129
|
+
### 远程 HTTP 客户端
|
|
124
130
|
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
也可以通过环境变量指定技能库路径：
|
|
131
|
+
如果你的客户端需要以远程 HTTP 地址接入 MCP（例如 ChatGPT 桌面端集成场景）：
|
|
128
132
|
|
|
129
133
|
```bash
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
134
|
+
node dist/index.js --http --port 3456
|
|
135
|
+
ngrok http 3456
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
将 `https://xxxx-xxxx.ngrok-free.app/mcp` 填入客户端的 MCP Server URL。
|
|
139
|
+
|
|
140
|
+
> 💡 ngrok 免费版每次重启会更换地址；需要固定地址可使用付费版或其他隧道工具（如 Cloudflare Tunnel）。
|
|
141
|
+
|
|
142
|
+
## 工作原理
|
|
143
|
+
|
|
144
|
+
```mermaid
|
|
145
|
+
flowchart LR
|
|
146
|
+
A["启动 MCP"] --> B["拉取清单 manifest + 建本地索引"]
|
|
147
|
+
B --> C["search_skills 秒出结果"]
|
|
148
|
+
C --> D["read_skill 按需拉取技能全文"]
|
|
149
|
+
D --> E["load_skill_file 按需读脚本/配置"]
|
|
150
|
+
E --> F["Agent 在本机执行"]
|
|
135
151
|
```
|
|
136
152
|
|
|
137
|
-
|
|
153
|
+
| 阶段 | 行为 | 耗时 |
|
|
154
|
+
|------|------|------|
|
|
155
|
+
| 启动 | 拉取/加载清单 + 建索引 | 秒级 |
|
|
156
|
+
| 搜索 | 本地索引关键词打分 | 毫秒级 |
|
|
157
|
+
| 取技能 | 2 次 GitHub API 列出文件 → 并发下载缺失文件 | 首次数秒，之后走缓存 |
|
|
158
|
+
|
|
159
|
+
### 网络加速回退链
|
|
138
160
|
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
161
|
+
所有远端文件请求按顺序自动回退，无需任何参数：
|
|
162
|
+
|
|
163
|
+
1. **GitHub 官方直连**（3 秒超时）；
|
|
164
|
+
2. **jsDelivr CDN**（10 秒超时，国内有节点）；
|
|
165
|
+
3. **gh-proxy.com**（10 秒超时）；
|
|
166
|
+
4. **ghfast.top**（10 秒超时）。
|
|
167
|
+
|
|
168
|
+
前一个节点失败时自动降级到下一个；全部失败才会报错。
|
|
169
|
+
|
|
170
|
+
### 缓存与增量同步
|
|
171
|
+
|
|
172
|
+
- 清单与技能文件缓存在当前目录 `.codex-skills-cache/`，二次启动秒级完成；
|
|
173
|
+
- 每个技能带 `.codex-skills.tree.json` 标记（文件列表 + 完成状态）；
|
|
174
|
+
- 已完整下载的技能直接本地读取，不重复请求远端；
|
|
175
|
+
- 中断的下载支持断点续传：按文件大小比对，只补拉缺失/不完整的文件；
|
|
176
|
+
- 技能文件并发下载，默认 16（可用 `--download-concurrency` 调整）；
|
|
177
|
+
- 需要强制同步远端最新内容时，删除 `.codex-skills-cache/` 后重启即可。
|
|
143
178
|
|
|
144
179
|
## MCP Tools
|
|
145
180
|
|
|
146
181
|
### 🔍 search_skills
|
|
147
|
-
|
|
182
|
+
|
|
183
|
+
搜索技能库，Agent 的主入口。
|
|
148
184
|
|
|
149
185
|
```
|
|
150
186
|
input: { query: "前端性能优化", category?: "01_代码工程与架构", limit?: 8 }
|
|
151
|
-
output:
|
|
187
|
+
output: 按相关度排序的技能列表（名称、分类、分数、描述）
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
### 📋 list_categories
|
|
191
|
+
|
|
192
|
+
列出所有技能分类和数量。
|
|
193
|
+
|
|
194
|
+
```
|
|
195
|
+
input: {}
|
|
196
|
+
output: 14 个分类 + 各自的技能数量
|
|
152
197
|
```
|
|
153
198
|
|
|
154
199
|
### 📖 read_skill
|
|
155
|
-
|
|
200
|
+
|
|
201
|
+
读取技能的完整指令（SKILL.md）+ 文件结构 + 环境依赖 + 子技能。
|
|
156
202
|
|
|
157
203
|
```
|
|
158
204
|
input: { name: "MediaCrawler" }
|
|
159
|
-
output: { instructions, structure, dependencies }
|
|
205
|
+
output: { instructions, structure, dependencies, sub_skills }
|
|
160
206
|
```
|
|
161
207
|
|
|
162
208
|
### 📂 load_skill_file
|
|
209
|
+
|
|
163
210
|
按需读取技能内的任意文件。
|
|
164
211
|
|
|
165
212
|
```
|
|
@@ -167,23 +214,19 @@ input: { skill_name: "KrillinAI", file_path: "README.md" }
|
|
|
167
214
|
output: { content, size_bytes }
|
|
168
215
|
```
|
|
169
216
|
|
|
217
|
+
> 单文件上限 500KB；二进制文件返回占位说明而非内容；路径穿越会自动拦截。
|
|
218
|
+
|
|
170
219
|
### 🗂️ list_skill_files
|
|
220
|
+
|
|
171
221
|
浏览技能的文件树（不读内容）。
|
|
172
222
|
|
|
173
223
|
```
|
|
174
|
-
input: { skill_name: "remotion-skills", path?: "src", max_depth?:
|
|
224
|
+
input: { skill_name: "remotion-skills", path?: "src", max_depth?: 2 }
|
|
175
225
|
output: 目录树
|
|
176
226
|
```
|
|
177
227
|
|
|
178
|
-
### 📋 list_categories
|
|
179
|
-
列出所有技能分类和数量。
|
|
180
|
-
|
|
181
|
-
```
|
|
182
|
-
input: {}
|
|
183
|
-
output: 14 个分类 + 各自的技能数量
|
|
184
|
-
```
|
|
185
|
-
|
|
186
228
|
### 🔗 plan_workflow
|
|
229
|
+
|
|
187
230
|
给定任务描述，推荐可组合使用的技能。
|
|
188
231
|
|
|
189
232
|
```
|
|
@@ -208,12 +251,42 @@ Agent → load_skill_file("KrillinAI", "README.md")
|
|
|
208
251
|
Agent → 按 SKILL.md 指令执行任务
|
|
209
252
|
```
|
|
210
253
|
|
|
254
|
+
## 配置参考
|
|
255
|
+
|
|
256
|
+
| 参数 | 默认值 | 说明 |
|
|
257
|
+
|------|--------|------|
|
|
258
|
+
| `--skills-dir <path>` | - | 本地技能库目录（指定后进入本地模式） |
|
|
259
|
+
| `--local` | - | 强制本地模式（从 cwd 或 `--skills-dir` 查找清单） |
|
|
260
|
+
| `--github-repo` | `Zhan-ZhangZ/codexprojec` | 远端技能库仓库 |
|
|
261
|
+
| `--github-branch` | `main-lite` | 远端分支 |
|
|
262
|
+
| `--github-path` | `codex-skills` | 技能库在仓库内的目录 |
|
|
263
|
+
| `--github-token` | 自动从 git 凭据 / `GITHUB_TOKEN` 获取 | GitHub API 鉴权 |
|
|
264
|
+
| `--http` | - | 启动 HTTP 模式 |
|
|
265
|
+
| `--port` | `3456` | HTTP 端口 |
|
|
266
|
+
| `--download-concurrency` | `16` | 技能文件并发下载数 |
|
|
267
|
+
| `--cn-mirror` | - | ⚠️ 已废弃（兼容保留）：网络加速现为自动回退链，此参数不再生效 |
|
|
268
|
+
|
|
269
|
+
环境变量：`CODEX_SKILLS_DIR`（本地技能库路径）、`GITHUB_TOKEN`、`CODEX_SKILLS_DOWNLOAD_CONCURRENCY`。
|
|
270
|
+
|
|
271
|
+
技能库清单（`skills_manifest.json`）为 JSON 数组，每项包含 `name` / `description` / `category` / `folder` / `relative_path` 五个字段。
|
|
272
|
+
|
|
273
|
+
## 常见问题
|
|
274
|
+
|
|
275
|
+
| 问题 | 处理 |
|
|
276
|
+
|------|------|
|
|
277
|
+
| npx 首次运行较慢 | 首次需下载 npm 包 + 拉取清单，属正常；之后走缓存 |
|
|
278
|
+
| 日志出现 `Network warning` | 当前加速节点失败，自动降级到下一个，可忽略 |
|
|
279
|
+
| 想强制更新技能内容 | 删除 `.codex-skills-cache/` 后重启 |
|
|
280
|
+
| `load_skill_file` 读大文件失败 | 单文件上限 500KB，属保护设计 |
|
|
281
|
+
| GitHub API 限流 | 每个技能仅 2 次 API 调用，已缓存技能不再请求；未登录配额 60 次/小时 |
|
|
282
|
+
| 工具列表里看不到 MCP | 客户端未重启，重启会话即可 |
|
|
283
|
+
|
|
211
284
|
## 技术栈
|
|
212
285
|
|
|
213
286
|
- TypeScript + ESM
|
|
214
287
|
- `@modelcontextprotocol/sdk` v1.12+
|
|
215
|
-
- `express`
|
|
216
|
-
- `zod` 运行时 schema 验证
|
|
288
|
+
- `express` v5（仅 HTTP 模式）
|
|
289
|
+
- `zod` v3 运行时 schema 验证
|
|
217
290
|
- Node.js 18+
|
|
218
291
|
|
|
219
292
|
## License
|
package/dist/config.d.ts
CHANGED
|
@@ -8,6 +8,8 @@ export interface Config {
|
|
|
8
8
|
githubToken?: string;
|
|
9
9
|
useCnMirror: boolean;
|
|
10
10
|
downloadConcurrency: number;
|
|
11
|
+
/** Manifest cache TTL in milliseconds. Default 24 hours. 0 = never refresh. */
|
|
12
|
+
manifestTTL: number;
|
|
11
13
|
}
|
|
12
14
|
/**
|
|
13
15
|
* Parse config from CLI args and env vars.
|
|
@@ -19,6 +21,12 @@ export interface ManifestEntry {
|
|
|
19
21
|
category: string;
|
|
20
22
|
folder: string;
|
|
21
23
|
relative_path: string;
|
|
24
|
+
aliases?: string[];
|
|
25
|
+
tags?: string[];
|
|
26
|
+
language?: string;
|
|
27
|
+
dependencies?: string[];
|
|
28
|
+
updated_at?: string;
|
|
29
|
+
stars?: number;
|
|
22
30
|
}
|
|
23
31
|
export declare function loadManifest(manifestPath: string): ManifestEntry[];
|
|
24
32
|
//# sourceMappingURL=config.d.ts.map
|
package/dist/config.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,MAAM;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;
|
|
1
|
+
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,MAAM;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC;CACrB;AAuBD;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAoGlD;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IAEtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,EAAE,CAGlE"}
|
package/dist/config.js
CHANGED
|
@@ -6,7 +6,7 @@ import { execSync } from "node:child_process";
|
|
|
6
6
|
*/
|
|
7
7
|
function getGitGithubToken() {
|
|
8
8
|
try {
|
|
9
|
-
const output = execSync('
|
|
9
|
+
const output = execSync('printf "protocol=https\nhost=github.com\n" | git credential fill', {
|
|
10
10
|
encoding: "utf-8",
|
|
11
11
|
stdio: ["pipe", "pipe", "ignore"]
|
|
12
12
|
});
|
|
@@ -83,6 +83,9 @@ export function parseConfig(args) {
|
|
|
83
83
|
process.exit(1);
|
|
84
84
|
}
|
|
85
85
|
const useCnMirror = args.includes("--cn-mirror");
|
|
86
|
+
// Manifest cache TTL (default: 24 hours). --manifest-ttl <seconds> or 0 to disable.
|
|
87
|
+
const ttlArg = getArg("--manifest-ttl");
|
|
88
|
+
const manifestTTL = ttlArg !== undefined ? parseInt(ttlArg, 10) * 1000 : 24 * 60 * 60 * 1000;
|
|
86
89
|
// Concurrent downloads for skill files (default 16). Configurable via
|
|
87
90
|
// --download-concurrency <n> or CODEX_SKILLS_DOWNLOAD_CONCURRENCY env var.
|
|
88
91
|
const concurrencyArg = getArg("--download-concurrency");
|
|
@@ -101,7 +104,8 @@ export function parseConfig(args) {
|
|
|
101
104
|
githubPath,
|
|
102
105
|
githubToken,
|
|
103
106
|
useCnMirror,
|
|
104
|
-
downloadConcurrency
|
|
107
|
+
downloadConcurrency,
|
|
108
|
+
manifestTTL
|
|
105
109
|
};
|
|
106
110
|
}
|
|
107
111
|
export function loadManifest(manifestPath) {
|
package/dist/config.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;
|
|
1
|
+
{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -6,14 +6,14 @@
|
|
|
6
6
|
* library via the Model Context Protocol (MCP).
|
|
7
7
|
*
|
|
8
8
|
* Supports two transport modes:
|
|
9
|
-
* 1. stdio (default) — for Claude Desktop, Cursor, Windsurf etc.
|
|
10
|
-
* 2. HTTP (--http) — for
|
|
9
|
+
* 1. stdio (default) — for Codex, ChatGPT, Claude Desktop, Cursor, Windsurf etc.
|
|
10
|
+
* 2. HTTP (--http) — for remote clients or Streamable HTTP connections
|
|
11
11
|
*
|
|
12
12
|
* Usage:
|
|
13
13
|
* # stdio mode (default)
|
|
14
14
|
* node dist/index.js --skills-dir /path/to/codex-skills
|
|
15
15
|
*
|
|
16
|
-
* # HTTP mode (for
|
|
16
|
+
* # HTTP mode (for remote connections or HTTP clients)
|
|
17
17
|
* node dist/index.js --skills-dir /path/to/codex-skills --http --port 3456
|
|
18
18
|
*/
|
|
19
19
|
export {};
|
package/dist/index.js
CHANGED
|
@@ -6,14 +6,14 @@
|
|
|
6
6
|
* library via the Model Context Protocol (MCP).
|
|
7
7
|
*
|
|
8
8
|
* Supports two transport modes:
|
|
9
|
-
* 1. stdio (default) — for Claude Desktop, Cursor, Windsurf etc.
|
|
10
|
-
* 2. HTTP (--http) — for
|
|
9
|
+
* 1. stdio (default) — for Codex, ChatGPT, Claude Desktop, Cursor, Windsurf etc.
|
|
10
|
+
* 2. HTTP (--http) — for remote clients or Streamable HTTP connections
|
|
11
11
|
*
|
|
12
12
|
* Usage:
|
|
13
13
|
* # stdio mode (default)
|
|
14
14
|
* node dist/index.js --skills-dir /path/to/codex-skills
|
|
15
15
|
*
|
|
16
|
-
* # HTTP mode (for
|
|
16
|
+
* # HTTP mode (for remote connections or HTTP clients)
|
|
17
17
|
* node dist/index.js --skills-dir /path/to/codex-skills --http --port 3456
|
|
18
18
|
*/
|
|
19
19
|
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
@@ -31,7 +31,7 @@ import { registerPlanWorkflow } from "./tools/plan-workflow.js";
|
|
|
31
31
|
function createServer(searchEngine, loader) {
|
|
32
32
|
const server = new McpServer({
|
|
33
33
|
name: "codex-skills",
|
|
34
|
-
version: "1.0
|
|
34
|
+
version: "1.1.0",
|
|
35
35
|
});
|
|
36
36
|
registerSearchSkills(server, searchEngine);
|
|
37
37
|
registerListCategories(server, searchEngine);
|
|
@@ -53,28 +53,50 @@ async function startHTTP(searchEngine, loader, port) {
|
|
|
53
53
|
const { default: express } = await import("express");
|
|
54
54
|
const app = express();
|
|
55
55
|
app.use(express.json());
|
|
56
|
-
//
|
|
57
|
-
const
|
|
56
|
+
// Session management with activity tracking for timeout cleanup
|
|
57
|
+
const SESSION_TTL_MS = 30 * 60 * 1000; // 30 minutes idle timeout
|
|
58
|
+
const sessions = new Map();
|
|
59
|
+
/** Touch session activity timestamp */
|
|
60
|
+
function touchSession(sid) {
|
|
61
|
+
const entry = sessions.get(sid);
|
|
62
|
+
if (entry)
|
|
63
|
+
entry.lastActivity = Date.now();
|
|
64
|
+
}
|
|
65
|
+
// Periodic cleanup of idle sessions (every 5 minutes)
|
|
66
|
+
setInterval(() => {
|
|
67
|
+
const now = Date.now();
|
|
68
|
+
for (const [sid, entry] of sessions) {
|
|
69
|
+
if (now - entry.lastActivity > SESSION_TTL_MS) {
|
|
70
|
+
console.error(`[codex-skills-mcp] Evicting idle session: ${sid.substring(0, 8)}...`);
|
|
71
|
+
try {
|
|
72
|
+
entry.transport.close?.();
|
|
73
|
+
}
|
|
74
|
+
catch { /* ignore */ }
|
|
75
|
+
sessions.delete(sid);
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
}, 5 * 60 * 1000).unref(); // unref so it doesn't prevent process exit
|
|
58
79
|
// MCP endpoint — handles POST (messages) and GET (SSE stream) and DELETE (session close)
|
|
59
80
|
app.post("/mcp", async (req, res) => {
|
|
60
81
|
const sessionId = req.headers["mcp-session-id"];
|
|
61
82
|
let transport;
|
|
62
|
-
if (sessionId &&
|
|
63
|
-
transport =
|
|
83
|
+
if (sessionId && sessions.has(sessionId)) {
|
|
84
|
+
transport = sessions.get(sessionId).transport;
|
|
85
|
+
touchSession(sessionId);
|
|
64
86
|
}
|
|
65
87
|
else {
|
|
66
88
|
// New session
|
|
67
89
|
transport = new StreamableHTTPServerTransport({
|
|
68
90
|
sessionIdGenerator: () => crypto.randomUUID(),
|
|
69
91
|
onsessioninitialized: (sid) => {
|
|
70
|
-
|
|
92
|
+
sessions.set(sid, { transport, lastActivity: Date.now() });
|
|
71
93
|
console.error(`[codex-skills-mcp] New session: ${sid}`);
|
|
72
94
|
},
|
|
73
95
|
});
|
|
74
96
|
transport.onclose = () => {
|
|
75
97
|
const sid = transport.sessionId;
|
|
76
98
|
if (sid)
|
|
77
|
-
|
|
99
|
+
sessions.delete(sid);
|
|
78
100
|
};
|
|
79
101
|
// Each session gets its own server instance
|
|
80
102
|
const server = createServer(searchEngine, loader);
|
|
@@ -85,20 +107,21 @@ async function startHTTP(searchEngine, loader, port) {
|
|
|
85
107
|
// GET endpoint for SSE stream (needed by some clients)
|
|
86
108
|
app.get("/mcp", async (req, res) => {
|
|
87
109
|
const sessionId = req.headers["mcp-session-id"];
|
|
88
|
-
if (!sessionId || !
|
|
110
|
+
if (!sessionId || !sessions.has(sessionId)) {
|
|
89
111
|
res.status(400).json({ error: "Invalid or missing session ID" });
|
|
90
112
|
return;
|
|
91
113
|
}
|
|
92
|
-
|
|
114
|
+
touchSession(sessionId);
|
|
115
|
+
const transport = sessions.get(sessionId).transport;
|
|
93
116
|
await transport.handleRequest(req, res);
|
|
94
117
|
});
|
|
95
118
|
// DELETE endpoint for session cleanup
|
|
96
119
|
app.delete("/mcp", async (req, res) => {
|
|
97
120
|
const sessionId = req.headers["mcp-session-id"];
|
|
98
|
-
if (sessionId &&
|
|
99
|
-
const transport =
|
|
121
|
+
if (sessionId && sessions.has(sessionId)) {
|
|
122
|
+
const transport = sessions.get(sessionId).transport;
|
|
100
123
|
await transport.handleRequest(req, res);
|
|
101
|
-
|
|
124
|
+
sessions.delete(sessionId);
|
|
102
125
|
}
|
|
103
126
|
else {
|
|
104
127
|
res.status(200).end();
|
|
@@ -109,15 +132,16 @@ async function startHTTP(searchEngine, loader, port) {
|
|
|
109
132
|
res.json({
|
|
110
133
|
status: "ok",
|
|
111
134
|
name: "codex-skills-mcp",
|
|
112
|
-
version: "1.0
|
|
135
|
+
version: "1.1.0",
|
|
113
136
|
skills: searchEngine.getCategories().reduce((s, c) => s + c.skill_count, 0),
|
|
137
|
+
activeSessions: sessions.size,
|
|
114
138
|
});
|
|
115
139
|
});
|
|
116
140
|
console.error("[codex-skills-mcp] 6 tools registered, starting HTTP server...");
|
|
117
141
|
app.listen(port, () => {
|
|
118
142
|
console.error(`[codex-skills-mcp] HTTP server running at http://localhost:${port}/mcp`);
|
|
119
143
|
console.error(`[codex-skills-mcp] Health check: http://localhost:${port}/health`);
|
|
120
|
-
console.error(`[codex-skills-mcp] For
|
|
144
|
+
console.error(`[codex-skills-mcp] For remote clients: use ngrok or similar to expose this endpoint`);
|
|
121
145
|
});
|
|
122
146
|
}
|
|
123
147
|
async function main() {
|
|
@@ -135,7 +159,7 @@ async function main() {
|
|
|
135
159
|
const manifest = loadManifest(config.manifestPath);
|
|
136
160
|
console.error(`[codex-skills-mcp] Loaded ${manifest.length} skills`);
|
|
137
161
|
// Build search index
|
|
138
|
-
const searchEngine = new SkillSearchEngine(manifest);
|
|
162
|
+
const searchEngine = new SkillSearchEngine(manifest, config);
|
|
139
163
|
const categories = searchEngine.getCategories();
|
|
140
164
|
console.error(`[codex-skills-mcp] Index built: ${categories.length} categories, ` +
|
|
141
165
|
`${categories.reduce((s, c) => s + c.skill_count, 0)} indexed skills`);
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAEnG,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,SAAS,YAAY,CACnB,YAA+B,EAC/B,MAAmB;IAEnB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,oBAAoB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC3C,sBAAsB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC7C,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IAChD,qBAAqB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IACpD,sBAAsB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IACrD,oBAAoB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAE3C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,YAA+B,EAC/B,MAAmB;IAEnB,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAElD,OAAO,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;IAEjF,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;AAC9D,CAAC;AAED,KAAK,UAAU,SAAS,CACtB,YAA+B,EAC/B,MAAmB,EACnB,IAAY;IAEZ,wDAAwD;IACxD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IAErD,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAExB,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/loader/index.d.ts
CHANGED
|
@@ -31,7 +31,10 @@ export declare class SkillLoader {
|
|
|
31
31
|
private config;
|
|
32
32
|
private manifest;
|
|
33
33
|
private skillsDir;
|
|
34
|
+
private _ensureSkillFetched;
|
|
34
35
|
constructor(config: Config, manifest: ManifestEntry[]);
|
|
36
|
+
/** Lazy-load remote module only when needed */
|
|
37
|
+
private ensureRemoteFetched;
|
|
35
38
|
/**
|
|
36
39
|
* Resolve the absolute filesystem path for a skill.
|
|
37
40
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/loader/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/loader/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,UAAU,EAAE,YAAY,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,cAAc,CAAC;IAC1B,YAAY,EAAE,iBAAiB,CAAC;CACjC;AAYD;;GAEG;AACH,qBAAa,WAAW;IAKpB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,QAAQ;IALlB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,mBAAmB,CAA0E;gBAG3F,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,aAAa,EAAE;IAKnC,+CAA+C;YACjC,mBAAmB;IAQjC;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM;IAM9C;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC;IAyB/D;;OAEG;IACH,aAAa,CACX,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,EACpB,QAAQ,GAAE,MAAU,GACnB,cAAc;IAUjB,OAAO,CAAC,aAAa;IA+CrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAuCrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA8C1B;;OAEG;IACG,aAAa,CACjB,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAiDnD;;OAEG;IACG,cAAc,CAClB,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,MAAW,EACpB,QAAQ,GAAE,MAAU,GACnB,OAAO,CAAC,QAAQ,EAAE,CAAC;CAmBvB"}
|