@perrylink/dsh-cert-mcp 0.1.4 → 0.1.6

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/LICENSE CHANGED
@@ -1,201 +1,201 @@
1
- Apache License
2
- Version 2.0, January 2004
3
- http://www.apache.org/licenses/
4
-
5
- TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6
-
7
- 1. Definitions.
8
-
9
- "License" shall mean the terms and conditions for use, reproduction,
10
- and distribution as defined by Sections 1 through 9 of this document.
11
-
12
- "Licensor" shall mean the copyright owner or entity authorized by
13
- the copyright owner that is granting the License.
14
-
15
- "Legal Entity" shall mean the union of the acting entity and all
16
- other entities that control, are controlled by, or are under common
17
- control with that entity. For the purposes of this definition,
18
- "control" means (i) the power, direct or indirect, to cause the
19
- direction or management of such entity, whether by contract or
20
- otherwise, or (ii) ownership of fifty percent (50%) or more of the
21
- outstanding shares, or (iii) beneficial ownership of such entity.
22
-
23
- "You" (or "Your") shall mean an individual or Legal Entity
24
- exercising permissions granted by this License.
25
-
26
- "Source" form shall mean the preferred form for making modifications,
27
- including but not limited to software source code, documentation
28
- source, and configuration files.
29
-
30
- "Object" form shall mean any form resulting from mechanical
31
- transformation or translation of a Source form, including but
32
- not limited to compiled object code, generated documentation,
33
- and conversions to other media types.
34
-
35
- "Work" shall mean the work of authorship, whether in Source or
36
- Object form, made available under the License, as indicated by a
37
- copyright notice that is included in or attached to the work
38
- (an example is provided in the Appendix below).
39
-
40
- "Derivative Works" shall mean any work, whether in Source or Object
41
- form, that is based on (or derived from) the Work and for which the
42
- editorial revisions, annotations, elaborations, or other modifications
43
- represent, as a whole, an original work of authorship. For the purposes
44
- of this License, Derivative Works shall not include works that remain
45
- separable from, or merely link (or bind by name) to the interfaces of,
46
- the Work and Derivative Works thereof.
47
-
48
- "Contribution" shall mean any work of authorship, including
49
- the original version of the Work and any modifications or additions
50
- to that Work or Derivative Works thereof, that is intentionally
51
- submitted to Licensor for inclusion in the Work by the copyright owner
52
- or by an individual or Legal Entity authorized to submit on behalf of
53
- the copyright owner. For the purposes of this definition, "submitted"
54
- means any form of electronic, verbal, or written communication sent
55
- to the Licensor or its representatives, including but not limited to
56
- communication on electronic mailing lists, source code control systems,
57
- and issue tracking systems that are managed by, or on behalf of, the
58
- Licensor for the purpose of discussing and improving the Work, but
59
- excluding communication that is conspicuously marked or otherwise
60
- designated in writing by the copyright owner as "Not a Contribution."
61
-
62
- "Contributor" shall mean Licensor and any individual or Legal Entity
63
- on behalf of whom a Contribution has been received by Licensor and
64
- subsequently incorporated within the Work.
65
-
66
- 2. Grant of Copyright License. Subject to the terms and conditions of
67
- this License, each Contributor hereby grants to You a perpetual,
68
- worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69
- copyright license to reproduce, prepare Derivative Works of,
70
- publicly display, publicly perform, sublicense, and distribute the
71
- Work and such Derivative Works in Source or Object form.
72
-
73
- 3. Grant of Patent License. Subject to the terms and conditions of
74
- this License, each Contributor hereby grants to You a perpetual,
75
- worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76
- (except as stated in this section) patent license to make, have made,
77
- use, offer to sell, sell, import, and otherwise transfer the Work,
78
- where such license applies only to those patent claims licensable
79
- by such Contributor that are necessarily infringed by their
80
- Contribution(s) alone or by combination of their Contribution(s)
81
- with the Work to which such Contribution(s) was submitted. If You
82
- institute patent litigation against any entity (including a
83
- cross-claim or counterclaim in a lawsuit) alleging that the Work
84
- or a Contribution incorporated within the Work constitutes direct
85
- or contributory patent infringement, then any patent licenses
86
- granted to You under this License for that Work shall terminate
87
- as of the date such litigation is filed.
88
-
89
- 4. Redistribution. You may reproduce and distribute copies of the
90
- Work or Derivative Works thereof in any medium, with or without
91
- modifications, and in Source or Object form, provided that You
92
- meet the following conditions:
93
-
94
- (a) You must give any other recipients of the Work or
95
- Derivative Works a copy of this License; and
96
-
97
- (b) You must cause any modified files to carry prominent notices
98
- stating that You changed the files; and
99
-
100
- (c) You must retain, in the Source form of any Derivative Works
101
- that You distribute, all copyright, patent, trademark, and
102
- attribution notices from the Source form of the Work,
103
- excluding those notices that do not pertain to any part of
104
- the Derivative Works; and
105
-
106
- (d) If the Work includes a "NOTICE" text file as part of its
107
- distribution, then any Derivative Works that You distribute must
108
- include a readable copy of the attribution notices contained
109
- within such NOTICE file, excluding those notices that do not
110
- pertain to any part of the Derivative Works, in at least one
111
- of the following places: within a NOTICE text file distributed
112
- as part of the Derivative Works; within the Source form or
113
- documentation, if provided along with the Derivative Works; or,
114
- within a display generated by the Derivative Works, if and
115
- wherever such third-party notices normally appear. The contents
116
- of the NOTICE file are for informational purposes only and
117
- do not modify the License. You may add Your own attribution
118
- notices within Derivative Works that You distribute, alongside
119
- or as an addendum to the NOTICE text from the Work, provided
120
- that such additional attribution notices cannot be construed
121
- as modifying the License.
122
-
123
- You may add Your own copyright statement to Your modifications and
124
- may provide additional or different license terms and conditions
125
- for use, reproduction, or distribution of Your modifications, or
126
- for any such Derivative Works as a whole, provided Your use,
127
- reproduction, and distribution of the Work otherwise complies with
128
- the conditions stated in this License.
129
-
130
- 5. Submission of Contributions. Unless You explicitly state otherwise,
131
- any Contribution intentionally submitted for inclusion in the Work
132
- by You to the Licensor shall be under the terms and conditions of
133
- this License, without any additional terms or conditions.
134
- Notwithstanding the above, nothing herein shall supersede or modify
135
- the terms of any separate license agreement you may have executed
136
- with Licensor regarding such Contributions.
137
-
138
- 6. Trademarks. This License does not grant permission to use the trade
139
- names, trademarks, service marks, or product names of the Licensor,
140
- except as required for reasonable and customary use in describing the
141
- origin of the Work and reproducing the content of the NOTICE file.
142
-
143
- 7. Disclaimer of Warranty. Unless required by applicable law or
144
- agreed to in writing, Licensor provides the Work (and each
145
- Contributor provides its Contributions) on an "AS IS" BASIS,
146
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147
- implied, including, without limitation, any warranties or conditions
148
- of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149
- PARTICULAR PURPOSE. You are solely responsible for determining the
150
- appropriateness of using or redistributing the Work and assume any
151
- risks associated with Your exercise of permissions under this License.
152
-
153
- 8. Limitation of Liability. In no event and under no legal theory,
154
- whether in tort (including negligence), contract, or otherwise,
155
- unless required by applicable law (such as deliberate and grossly
156
- negligent acts) or agreed to in writing, shall any Contributor be
157
- liable to You for damages, including any direct, indirect, special,
158
- incidental, or consequential damages of any character arising as a
159
- result of this License or out of the use or inability to use the
160
- Work (including but not limited to damages for loss of goodwill,
161
- work stoppage, computer failure or malfunction, or any and all
162
- other commercial damages or losses), even if such Contributor
163
- has been advised of the possibility of such damages.
164
-
165
- 9. Accepting Warranty or Additional Liability. While redistributing
166
- the Work or Derivative Works thereof, You may choose to offer,
167
- and charge a fee for, acceptance of support, warranty, indemnity,
168
- or other liability obligations and/or rights consistent with this
169
- License. However, in accepting such obligations, You may act only
170
- on Your own behalf and on Your sole responsibility, not on behalf
171
- of any other Contributor, and only if You agree to indemnify,
172
- defend, and hold each Contributor harmless for any liability
173
- incurred by, or claims asserted against, such Contributor by reason
174
- of your accepting any such warranty or additional liability.
175
-
176
- END OF TERMS AND CONDITIONS
177
-
178
- APPENDIX: How to apply the Apache License to your work.
179
-
180
- To apply the Apache License to your work, attach the following
181
- boilerplate notice, with the fields enclosed by brackets "[]"
182
- replaced with your own identifying information. (Don't include
183
- the brackets!) The text should be enclosed in the appropriate
184
- comment syntax for the file format. We also recommend that a
185
- file or class name and description of purpose be included on the
186
- same "printed page" as the copyright notice for easier
187
- identification within third-party archives.
188
-
189
- Copyright [yyyy] [name of copyright owner]
190
-
191
- Licensed under the Apache License, Version 2.0 (the "License");
192
- you may not use this file except in compliance with the License.
193
- You may obtain a copy of the License at
194
-
195
- http://www.apache.org/licenses/LICENSE-2.0
196
-
197
- Unless required by applicable law or agreed to in writing, software
198
- distributed under the License is distributed on an "AS IS" BASIS,
199
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200
- See the License for the specific language governing permissions and
201
- limitations under the License.
1
+ Apache License
2
+ Version 2.0, January 2004
3
+ http://www.apache.org/licenses/
4
+
5
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6
+
7
+ 1. Definitions.
8
+
9
+ "License" shall mean the terms and conditions for use, reproduction,
10
+ and distribution as defined by Sections 1 through 9 of this document.
11
+
12
+ "Licensor" shall mean the copyright owner or entity authorized by
13
+ the copyright owner that is granting the License.
14
+
15
+ "Legal Entity" shall mean the union of the acting entity and all
16
+ other entities that control, are controlled by, or are under common
17
+ control with that entity. For the purposes of this definition,
18
+ "control" means (i) the power, direct or indirect, to cause the
19
+ direction or management of such entity, whether by contract or
20
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
21
+ outstanding shares, or (iii) beneficial ownership of such entity.
22
+
23
+ "You" (or "Your") shall mean an individual or Legal Entity
24
+ exercising permissions granted by this License.
25
+
26
+ "Source" form shall mean the preferred form for making modifications,
27
+ including but not limited to software source code, documentation
28
+ source, and configuration files.
29
+
30
+ "Object" form shall mean any form resulting from mechanical
31
+ transformation or translation of a Source form, including but
32
+ not limited to compiled object code, generated documentation,
33
+ and conversions to other media types.
34
+
35
+ "Work" shall mean the work of authorship, whether in Source or
36
+ Object form, made available under the License, as indicated by a
37
+ copyright notice that is included in or attached to the work
38
+ (an example is provided in the Appendix below).
39
+
40
+ "Derivative Works" shall mean any work, whether in Source or Object
41
+ form, that is based on (or derived from) the Work and for which the
42
+ editorial revisions, annotations, elaborations, or other modifications
43
+ represent, as a whole, an original work of authorship. For the purposes
44
+ of this License, Derivative Works shall not include works that remain
45
+ separable from, or merely link (or bind by name) to the interfaces of,
46
+ the Work and Derivative Works thereof.
47
+
48
+ "Contribution" shall mean any work of authorship, including
49
+ the original version of the Work and any modifications or additions
50
+ to that Work or Derivative Works thereof, that is intentionally
51
+ submitted to Licensor for inclusion in the Work by the copyright owner
52
+ or by an individual or Legal Entity authorized to submit on behalf of
53
+ the copyright owner. For the purposes of this definition, "submitted"
54
+ means any form of electronic, verbal, or written communication sent
55
+ to the Licensor or its representatives, including but not limited to
56
+ communication on electronic mailing lists, source code control systems,
57
+ and issue tracking systems that are managed by, or on behalf of, the
58
+ Licensor for the purpose of discussing and improving the Work, but
59
+ excluding communication that is conspicuously marked or otherwise
60
+ designated in writing by the copyright owner as "Not a Contribution."
61
+
62
+ "Contributor" shall mean Licensor and any individual or Legal Entity
63
+ on behalf of whom a Contribution has been received by Licensor and
64
+ subsequently incorporated within the Work.
65
+
66
+ 2. Grant of Copyright License. Subject to the terms and conditions of
67
+ this License, each Contributor hereby grants to You a perpetual,
68
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69
+ copyright license to reproduce, prepare Derivative Works of,
70
+ publicly display, publicly perform, sublicense, and distribute the
71
+ Work and such Derivative Works in Source or Object form.
72
+
73
+ 3. Grant of Patent License. Subject to the terms and conditions of
74
+ this License, each Contributor hereby grants to You a perpetual,
75
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76
+ (except as stated in this section) patent license to make, have made,
77
+ use, offer to sell, sell, import, and otherwise transfer the Work,
78
+ where such license applies only to those patent claims licensable
79
+ by such Contributor that are necessarily infringed by their
80
+ Contribution(s) alone or by combination of their Contribution(s)
81
+ with the Work to which such Contribution(s) was submitted. If You
82
+ institute patent litigation against any entity (including a
83
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
84
+ or a Contribution incorporated within the Work constitutes direct
85
+ or contributory patent infringement, then any patent licenses
86
+ granted to You under this License for that Work shall terminate
87
+ as of the date such litigation is filed.
88
+
89
+ 4. Redistribution. You may reproduce and distribute copies of the
90
+ Work or Derivative Works thereof in any medium, with or without
91
+ modifications, and in Source or Object form, provided that You
92
+ meet the following conditions:
93
+
94
+ (a) You must give any other recipients of the Work or
95
+ Derivative Works a copy of this License; and
96
+
97
+ (b) You must cause any modified files to carry prominent notices
98
+ stating that You changed the files; and
99
+
100
+ (c) You must retain, in the Source form of any Derivative Works
101
+ that You distribute, all copyright, patent, trademark, and
102
+ attribution notices from the Source form of the Work,
103
+ excluding those notices that do not pertain to any part of
104
+ the Derivative Works; and
105
+
106
+ (d) If the Work includes a "NOTICE" text file as part of its
107
+ distribution, then any Derivative Works that You distribute must
108
+ include a readable copy of the attribution notices contained
109
+ within such NOTICE file, excluding those notices that do not
110
+ pertain to any part of the Derivative Works, in at least one
111
+ of the following places: within a NOTICE text file distributed
112
+ as part of the Derivative Works; within the Source form or
113
+ documentation, if provided along with the Derivative Works; or,
114
+ within a display generated by the Derivative Works, if and
115
+ wherever such third-party notices normally appear. The contents
116
+ of the NOTICE file are for informational purposes only and
117
+ do not modify the License. You may add Your own attribution
118
+ notices within Derivative Works that You distribute, alongside
119
+ or as an addendum to the NOTICE text from the Work, provided
120
+ that such additional attribution notices cannot be construed
121
+ as modifying the License.
122
+
123
+ You may add Your own copyright statement to Your modifications and
124
+ may provide additional or different license terms and conditions
125
+ for use, reproduction, or distribution of Your modifications, or
126
+ for any such Derivative Works as a whole, provided Your use,
127
+ reproduction, and distribution of the Work otherwise complies with
128
+ the conditions stated in this License.
129
+
130
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
131
+ any Contribution intentionally submitted for inclusion in the Work
132
+ by You to the Licensor shall be under the terms and conditions of
133
+ this License, without any additional terms or conditions.
134
+ Notwithstanding the above, nothing herein shall supersede or modify
135
+ the terms of any separate license agreement you may have executed
136
+ with Licensor regarding such Contributions.
137
+
138
+ 6. Trademarks. This License does not grant permission to use the trade
139
+ names, trademarks, service marks, or product names of the Licensor,
140
+ except as required for reasonable and customary use in describing the
141
+ origin of the Work and reproducing the content of the NOTICE file.
142
+
143
+ 7. Disclaimer of Warranty. Unless required by applicable law or
144
+ agreed to in writing, Licensor provides the Work (and each
145
+ Contributor provides its Contributions) on an "AS IS" BASIS,
146
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147
+ implied, including, without limitation, any warranties or conditions
148
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149
+ PARTICULAR PURPOSE. You are solely responsible for determining the
150
+ appropriateness of using or redistributing the Work and assume any
151
+ risks associated with Your exercise of permissions under this License.
152
+
153
+ 8. Limitation of Liability. In no event and under no legal theory,
154
+ whether in tort (including negligence), contract, or otherwise,
155
+ unless required by applicable law (such as deliberate and grossly
156
+ negligent acts) or agreed to in writing, shall any Contributor be
157
+ liable to You for damages, including any direct, indirect, special,
158
+ incidental, or consequential damages of any character arising as a
159
+ result of this License or out of the use or inability to use the
160
+ Work (including but not limited to damages for loss of goodwill,
161
+ work stoppage, computer failure or malfunction, or any and all
162
+ other commercial damages or losses), even if such Contributor
163
+ has been advised of the possibility of such damages.
164
+
165
+ 9. Accepting Warranty or Additional Liability. While redistributing
166
+ the Work or Derivative Works thereof, You may choose to offer,
167
+ and charge a fee for, acceptance of support, warranty, indemnity,
168
+ or other liability obligations and/or rights consistent with this
169
+ License. However, in accepting such obligations, You may act only
170
+ on Your own behalf and on Your sole responsibility, not on behalf
171
+ of any other Contributor, and only if You agree to indemnify,
172
+ defend, and hold each Contributor harmless for any liability
173
+ incurred by, or claims asserted against, such Contributor by reason
174
+ of your accepting any such warranty or additional liability.
175
+
176
+ END OF TERMS AND CONDITIONS
177
+
178
+ APPENDIX: How to apply the Apache License to your work.
179
+
180
+ To apply the Apache License to your work, attach the following
181
+ boilerplate notice, with the fields enclosed by brackets "[]"
182
+ replaced with your own identifying information. (Don't include
183
+ the brackets!) The text should be enclosed in the appropriate
184
+ comment syntax for the file format. We also recommend that a
185
+ file or class name and description of purpose be included on the
186
+ same "printed page" as the copyright notice for easier
187
+ identification within third-party archives.
188
+
189
+ Copyright [yyyy] [name of copyright owner]
190
+
191
+ Licensed under the Apache License, Version 2.0 (the "License");
192
+ you may not use this file except in compliance with the License.
193
+ You may obtain a copy of the License at
194
+
195
+ http://www.apache.org/licenses/LICENSE-2.0
196
+
197
+ Unless required by applicable law or agreed to in writing, software
198
+ distributed under the License is distributed on an "AS IS" BASIS,
199
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200
+ See the License for the specific language governing permissions and
201
+ limitations under the License.
package/README.md CHANGED
@@ -1,73 +1,150 @@
1
- # dsh-cert-mcp
2
-
3
- [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
4
- [![DSH plugin](https://img.shields.io/badge/dsh--plugin-✅-green)](https://github.com/topics/dsh-plugin)
5
- [![Gitee](https://img.shields.io/badge/Gitee-mirror-c71d23?logo=gitee)](https://gitee.com/perrylink/dsh-cert-mcp)
6
- [![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-cert-mcp?label=version)](https://github.com/PerryLink/dsh-cert-mcp/releases)
7
- [![npm version](https://img.shields.io/npm/v/%40perrylink%2Fdsh-cert-mcp)](https://www.npmjs.com/package/@perrylink/dsh-cert-mcp)
8
- [![npm downloads](https://img.shields.io/npm/dm/%40perrylink%2Fdsh-cert-mcp)](https://www.npmjs.com/package/@perrylink/dsh-cert-mcp)
9
- [![dsh-cert-mcp MCP server](https://glama.ai/mcp/servers/PerryLink/dsh-cert-mcp/badges/score.svg)](https://glama.ai/mcp/servers/PerryLink/dsh-cert-mcp)
10
- [![dsh-cert-mcp MCP server](https://glama.ai/mcp/servers/PerryLink/dsh-cert-mcp/badges/card.svg)](https://glama.ai/mcp/servers/PerryLink/dsh-cert-mcp)
11
-
12
- Read-only [MCP](https://modelcontextprotocol.io) server that exposes the [dsh-plugin-certification](https://github.com/PerryLink/dsh-plugin-certification) registry: certification grades, snapshot dates and five-dimension evidence for DeepSeek Harness (DSH) plugins. Zero runtime dependencies, stdio transport.
13
-
14
- ## Tools
15
-
16
- | Tool | Input | Returns |
17
- |---|---|---|
18
- | `get_certification` | `owner`, `repo` | Full certification record (grade, snapshot, five dimensions, veto, notes) or "no record" |
19
- | `list_certified` | — | Every entry in the public registry: repo / grade / snapshot |
20
- | `certification_spec` | — | Spec v1 summary: five dimensions, grade scale, veto rule |
21
-
22
- The embedded snapshot lives in `data/certified.json` (synced from the certification repo) and the server refreshes it from the public registry at most once per five minutes. No writes, no secrets, no code execution.
23
-
24
- ## Install
25
-
26
- ```sh
27
- git clone https://github.com/PerryLink/dsh-cert-mcp
28
- cd dsh-cert-mcp
29
- node src/index.js # stdio server
30
- ```
31
-
32
- Run it directly from the published npm package: `npx @perrylink/dsh-cert-mcp`.
33
-
34
- ### Register in an MCP client
35
-
36
- Claude Code:
37
-
38
- ```sh
39
- claude mcp add dsh-cert -- node <path-to-repo>/src/index.js
40
- ```
41
-
42
- Claude Desktop (`claude_desktop_config.json`):
43
-
44
- ```json
45
- {
46
- "mcpServers": {
47
- "dsh-cert": {
48
- "command": "node",
49
- "args": ["<path-to-repo>/src/index.js"]
50
- }
51
- }
52
- }
53
- ```
54
-
55
- DSH: add it through [dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel) as a stdio server, or any MCP client that supports `stdio`.
56
-
57
- ## Why this exists
58
-
59
- The official DeepSeek Harness repository does not run a plugin registry and does not accept external PRs; discovery happens through the `dsh-plugin` GitHub topic and community lists, none of which certify anything. `dsh-plugin-certification` turns "can I install this plugin" into a reproducible five-dimension check (manifest, build hygiene, supply-chain Scorecard, release provenance, sandboxed install smoke test) with a public registry and README badges. This MCP server is the same data with an agent-facing interface: agents can look up a plugin's certification before recommending or installing it.
60
-
61
- ## Registry
62
-
63
- Data source: [PerryLink/dsh-plugin-certification](https://github.com/PerryLink/dsh-plugin-certification) — `data/certified.json`, spec v1.
64
-
65
- ## Development
66
-
67
- ```sh
68
- node test/smoke.mjs
69
- ```
70
-
71
- ## License
72
-
73
- Apache-2.0. A listing or grade is an evidence record, not a security guarantee: plugins run inside your DSH process with your permissions.
1
+ # dsh-cert-mcp
2
+
3
+ [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
4
+ [![DSH plugin](https://img.shields.io/badge/dsh--plugin-✅-green)](https://github.com/topics/dsh-plugin)
5
+ [![Gitee](https://img.shields.io/badge/Gitee-mirror-c71d23?logo=gitee)](https://gitee.com/perrylink/dsh-cert-mcp)
6
+ [![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-cert-mcp?label=version)](https://github.com/PerryLink/dsh-cert-mcp/releases)
7
+ [![npm version](https://img.shields.io/npm/v/%40perrylink%2Fdsh-cert-mcp)](https://www.npmjs.com/package/@perrylink/dsh-cert-mcp)
8
+ [![npm downloads](https://img.shields.io/npm/dm/%40perrylink%2Fdsh-cert-mcp)](https://www.npmjs.com/package/@perrylink/dsh-cert-mcp)
9
+ [![dsh-cert-mcp MCP server](https://glama.ai/mcp/servers/PerryLink/dsh-cert-mcp/badges/score.svg)](https://glama.ai/mcp/servers/PerryLink/dsh-cert-mcp)
10
+ [![dsh-cert-mcp MCP server](https://glama.ai/mcp/servers/PerryLink/dsh-cert-mcp/badges/card.svg)](https://glama.ai/mcp/servers/PerryLink/dsh-cert-mcp)
11
+
12
+ Read-only [MCP](https://modelcontextprotocol.io) server that exposes the [dsh-plugin-certification](https://github.com/PerryLink/dsh-plugin-certification) registry: certification grades, snapshot dates and five-dimension evidence for DeepSeek Harness (DSH) plugins. Zero runtime dependencies, stdio transport.
13
+
14
+ ## Tools
15
+
16
+ | Tool | Input | Returns |
17
+ |---|---|---|
18
+ | `get_certification` | `owner`, `repo` | Full certification record (grade, snapshot, five dimensions, veto, notes) or "no record" |
19
+ | `list_certified` | — | Every entry in the public registry: repo / grade / snapshot |
20
+ | `certification_spec` | — | Spec v1 summary: five dimensions, grade scale, veto rule |
21
+
22
+ The embedded snapshot lives in `data/certified.json` (synced from the certification repo) and the server refreshes it from the public registry at most once per five minutes. No writes, no secrets, no code execution.
23
+
24
+ ## Install
25
+
26
+ ```sh
27
+ git clone https://github.com/PerryLink/dsh-cert-mcp
28
+ cd dsh-cert-mcp
29
+ node src/index.js # stdio server
30
+ ```
31
+
32
+ Run it directly from the published npm package: `npx @perrylink/dsh-cert-mcp`.
33
+
34
+ ### Register in an MCP client
35
+
36
+ Claude Code:
37
+
38
+ ```sh
39
+ claude mcp add dsh-cert -- node <path-to-repo>/src/index.js
40
+ ```
41
+
42
+ Claude Desktop (`claude_desktop_config.json`):
43
+
44
+ ```json
45
+ {
46
+ "mcpServers": {
47
+ "dsh-cert": {
48
+ "command": "node",
49
+ "args": ["<path-to-repo>/src/index.js"]
50
+ }
51
+ }
52
+ }
53
+ ```
54
+
55
+ DSH: add it through [dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel) as a stdio server, or any MCP client that supports `stdio`.
56
+
57
+ ### Install as a DSH bundle
58
+
59
+ The package declares `dsh.bundle.patch` `cordis.patch.yml`, so it also installs as a DeepSeek Harness bundle:
60
+
61
+ ```sh
62
+ # git channel (latest main)
63
+ dsh plugin --profile web add "github:PerryLink/dsh-cert-mcp#main"
64
+
65
+ # npm channel (published releases)
66
+ dsh plugin --profile web add @perrylink/dsh-cert-mcp
67
+ ```
68
+
69
+ The inserted row loads the package through the standard Cordis plugin contract: the host half is a plain ESM module exporting `apply(ctx)` (declaring `inject` only when it needs services). This package ships no browser UI, so there is no `dsh.client` declaration.
70
+
71
+ ```js
72
+ // bundle entry (host half) — the contract the patch row loads
73
+ export function apply(ctx) {
74
+ // registers the read-only certification lookup surface
75
+ // (get_certification / list_certified / certification_spec)
76
+ }
77
+ ```
78
+
79
+ Remove it with `dsh plugin --profile web remove @perrylink/dsh-cert-mcp` (or delete the row from the profile patch). The standalone stdio MCP server above keeps working for any MCP client.
80
+
81
+ ## Why this exists
82
+
83
+ The official DeepSeek Harness repository does not run a plugin registry and does not accept external PRs; discovery happens through the `dsh-plugin` GitHub topic and community lists, none of which certify anything. `dsh-plugin-certification` turns "can I install this plugin" into a reproducible five-dimension check (manifest, build hygiene, supply-chain Scorecard, release provenance, sandboxed install smoke test) with a public registry and README badges. This MCP server is the same data with an agent-facing interface: agents can look up a plugin's certification before recommending or installing it.
84
+
85
+ ## Registry
86
+
87
+ Data source: [PerryLink/dsh-plugin-certification](https://github.com/PerryLink/dsh-plugin-certification) — `data/certified.json`, spec v1.
88
+
89
+ ## Development
90
+
91
+ ```sh
92
+ node test/smoke.mjs
93
+ ```
94
+
95
+ ## PerryLink DSH Plugin Family
96
+
97
+ This project is one of the [40 DeepSeek Harness plugins](https://github.com/PerryLink) maintained by [PerryLink](https://github.com/PerryLink). If this one helps you, the others likely will too:
98
+
99
+ | Plugin | One-liner |
100
+ |---|---|
101
+ | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | Second-model auto-review on the approval chain, fail-closed by default | |
102
+ | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | Automatic strong/cheap model-tier routing with deterministic risk guards and a `/tier` command | |
103
+ | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | Durable background child agents with a Web UI sidebar, messaging and interrupt | |
104
+ | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | Cost governance for DeepSeek Harness: budgets, carbon, and latency in one panel. | |
105
+ | **[dsh-catalog](https://github.com/PerryLink/dsh-catalog)** | DSH Desktop Market standard catalog source for the PerryLink family | |
106
+ | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | Unified session + workspace + config checkpoints with one-shot `/rewind` | |
107
+ | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | Migrate Claude Code, Codex, OpenCode and Hermes sessions, memories and skills into DSH | |
108
+ | **[dsh-click](https://github.com/PerryLink/dsh-click)** | Cross-platform native desktop control for DeepSeek Harness — Windows first. | |
109
+ | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | Terminal-style input history for the web composer: arrows, Ctrl+R search | |
110
+ | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | Deterministic dataset profiling, cleaning and citation verification | |
111
+ | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | Prompt-injection, jailbreak, and secret-leak defense for DeepSeek Harness. | |
112
+ | **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | Engineering-discipline guard: requirements grill, test gates, adversary review | |
113
+ | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | Unified static-image generation routing for DeepSeek Harness. | |
114
+ | **[dsh-fast](https://github.com/PerryLink/dsh-fast)** | Read-only performance diagnostics: load, spill, compaction and cache hit rate | |
115
+ | **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** | Chinese mutual-fund research with sealed, traceable source snapshots | |
116
+ | **[dsh-github](https://github.com/PerryLink/dsh-github)** | GitHub PR/issue/CI integration with every write approval-gated | |
117
+ | **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** | Industry and company research pack: chain map, policy timeline, company cards | |
118
+ | **[dsh-kit](https://github.com/PerryLink/dsh-kit)** | One-command starter pack that installs the core family | |
119
+ | **[dsh-library](https://github.com/PerryLink/dsh-library)** | Local document knowledge base with hybrid search and citation-aware injection | |
120
+ | **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | Local Ollama model discovery and task-based routing with cloud fallback | |
121
+ | **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** | LSP diagnostics, formatting, completion, code actions, symbols and rename | |
122
+ | **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | PII masking at the model boundary with a host-side restore table | |
123
+ | **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | MCP management console: `/mcp` command, Settings tab and trial calls | |
124
+ | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | Approval-gated cross-session memory protocol (`ctx.memory` + SQLite) | |
125
+ | **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | OpenTelemetry and Langfuse telemetry export from the session event stream | |
126
+ | **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | Runtime-switchable model output styles | |
127
+ | **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** | Declarative allow/deny/ask rules plus a process-level network policy | |
128
+ | **[dsh-plugin-certification](https://github.com/PerryLink/dsh-plugin-certification)** | Community certification registry with repro-checkable grades and badges | |
129
+ | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | Zero-dependency static + sandbox smoke detector for DSH plugins | |
130
+ | **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | Plugin-dev knowledge base, agent skill and the `dsh-plugin-dev` CLI toolchain | |
131
+ | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | Shared zero-runtime-dependency toolkit for the PerryLink DSH plugins | |
132
+ | **[dsh-plugin-portal](https://github.com/PerryLink/dsh-plugin-portal)** | Zero-dependency static portal rendering the whole plugin family as one page | |
133
+ | **[dsh-plugin-upgrade-015](https://github.com/PerryLink/dsh-plugin-upgrade-015)** | Merged `0.1.3-alpha.1` → `0.1.5-rc.1` upgrade corridor card plus a zero-dependency seam scanner | |
134
+ | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | Multi-channel approval/question bridge: WeChat, Telegram, Feishu + a session console | |
135
+ | **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** | Verifiable research reports: evidence ledger, manifest seal, per-claim verdicts | |
136
+ | **[dsh-score](https://github.com/PerryLink/dsh-score)** | Multi-dimensional plugin quality scoring with an evidence-backed leaderboard | |
137
+ | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | Pin sessions and workspaces in the Web sidebar with per-pin colors | |
138
+ | **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | Git-backed cross-device session synchronization with keep-both merges | |
139
+ | **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | Security-audit skill pack plus the `plugin_vet` supply-chain gate | |
140
+ | **[dsh-talk](https://github.com/PerryLink/dsh-talk)** | Voice-first session loop: speech-to-text input and text-to-speech replies | |
141
+ | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | Cross-session team rooms: shared message bus, task board and timeline | |
142
+ | **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | Isolated install-and-smoke test drives with a pass/fail matrix | |
143
+ | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | TickTick/Dida365 task bridge: session-header panel plus eleven agent tools | |
144
+ | **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | Vendor parameter translation and deterministic JSON repair | |
145
+ | **[dsh-wechat](https://github.com/pan17/dsh-wechat)** | WeChat ↔ DSH bridge (Tencent iLink bot) developed with [pan17](https://github.com/pan17/dsh-wechat), who hosts the repo | |
146
+ | **[dsh-personal-directive](https://github.com/PerryLink/dsh-personal-directive)** | Personal directive injector with a top-bar toggle (fork of liucai2026/dsh-personal-directive) | |
147
+
148
+ ## License
149
+
150
+ Apache-2.0. A listing or grade is an evidence record, not a security guarantee: plugins run inside your DSH process with your permissions.
@@ -0,0 +1,8 @@
1
+ # SPDX-License-Identifier: Apache-2.0
2
+ # dsh-cert-mcp bundle patch: mount the read-only certification-registry MCP
3
+ # package as a bundle row. `name` is the npm package name, resolved through
4
+ # the profile's node_modules; an id-targeted override replaces the whole
5
+ # config row — restate every key when overriding.
6
+ - insert:
7
+ - id: cert-mcp
8
+ name: '@perrylink/dsh-cert-mcp'
@@ -1,37 +1,37 @@
1
- {
2
- "specVersion": "v1",
3
- "generatedAt": "2026-09-07",
4
- "entries": [
5
- {
6
- "repo": "PerryLink/dsh-auto-review",
7
- "grade": "A",
8
- "specVersion": "v1",
9
- "snapshot": "2026-09-07",
10
- "dimensions": {
11
- "manifest": {
12
- "result": "pass",
13
- "evidence": "dsh.bundle manifest + Apache-2.0 + keywords/topics aligned + five-language READMEs + engines ^22.19.0 || >=24.0.0 (repo + npm registry scan 2026-09-07, v0.10.4)"
14
- },
15
- "buildHygiene": {
16
- "result": "pass",
17
- "evidence": "files allowlist + peerDependencies (optional client peers, range >=0.1.2-rc.1 <0.2.0 since 2026-09-05) + typecheck/test/build/check:readmes/pack gates; 2026-09-06 batch D-stage gate chain green at v0.10.4 (frozen install, typecheck, 276/276 tests, build, verify:self-contained, pack) + main ci success on 3f9cdae (2026-09-06T12:32Z); no malicious postinstall patterns"
18
- },
19
- "supplyChain": {
20
- "result": "pass",
21
- "score": 5.4,
22
- "evidence": "https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-auto-review fresh run 2026-09-06T12:32:32Z on main 3f9cdae (scorecard v5.5.0); Scorecard supply-chain workflow success on the same SHA"
23
- },
24
- "releaseIntegrity": {
25
- "result": "pass",
26
- "evidence": "npm publish --provenance via publish workflow with id-token + Trusted Publishing; dsh-auto-review@0.10.4 on npm since 2026-09-05T15:04Z - registry dist.attestations + slsa.dev/provenance/v1 + GitHub Actions trusted publisher verified directly 2026-09-07"
27
- },
28
- "installSmoke": {
29
- "result": "ok",
30
- "evidence": "2026-09-06 batch D-stage (isolated throwaway profile, npx @deepseek-ai/dsh@0.1.2-rc.1): the standard `dsh plugin --profile web add <tarball>` fails with ERR_PNPM_IGNORED_BUILDS (pnpm 11 ignored-builds environmental gate); the documented compat recipe (pnpm-workspace.yaml allowBuilds preset for dsh-subprocess-local/koffi/node-pty/protobufjs) then installs cleanly - add exit 0 (resolved 381, added 271), dump-config shows the plugin row + bundle layer, keyless headless reaches MISSING_CREDENTIAL (tree-load proof). Reproduction: _scratch/batch-2026-09-06/verify/dsh-auto-review.md"
31
- }
32
- },
33
- "veto": null,
34
- "notes": "Registry entry refreshed for 0.10.4 (published 2026-09-05 with OIDC provenance). E upgraded from environment-blocked to ok via the documented allowBuilds compat recipe (the same method the repo's compat.yml uses); the bare unattended install still hits pnpm's ignored-builds gate, recorded above. Grade B -> A."
35
- }
36
- ]
37
- }
1
+ {
2
+ "specVersion": "v1",
3
+ "generatedAt": "2026-09-07",
4
+ "entries": [
5
+ {
6
+ "repo": "PerryLink/dsh-auto-review",
7
+ "grade": "A",
8
+ "specVersion": "v1",
9
+ "snapshot": "2026-09-07",
10
+ "dimensions": {
11
+ "manifest": {
12
+ "result": "pass",
13
+ "evidence": "dsh.bundle manifest + Apache-2.0 + keywords/topics aligned + five-language READMEs + engines ^22.19.0 || >=24.0.0 (repo + npm registry scan 2026-09-07, v0.10.4)"
14
+ },
15
+ "buildHygiene": {
16
+ "result": "pass",
17
+ "evidence": "files allowlist + peerDependencies (optional client peers, range >=0.1.2-rc.1 <0.2.0 since 2026-09-05) + typecheck/test/build/check:readmes/pack gates; 2026-09-06 batch D-stage gate chain green at v0.10.4 (frozen install, typecheck, 276/276 tests, build, verify:self-contained, pack) + main ci success on 3f9cdae (2026-09-06T12:32Z); no malicious postinstall patterns"
18
+ },
19
+ "supplyChain": {
20
+ "result": "pass",
21
+ "score": 5.4,
22
+ "evidence": "https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-auto-review fresh run 2026-09-06T12:32:32Z on main 3f9cdae (scorecard v5.5.0); Scorecard supply-chain workflow success on the same SHA"
23
+ },
24
+ "releaseIntegrity": {
25
+ "result": "pass",
26
+ "evidence": "npm publish --provenance via publish workflow with id-token + Trusted Publishing; dsh-auto-review@0.10.4 on npm since 2026-09-05T15:04Z - registry dist.attestations + slsa.dev/provenance/v1 + GitHub Actions trusted publisher verified directly 2026-09-07"
27
+ },
28
+ "installSmoke": {
29
+ "result": "ok",
30
+ "evidence": "2026-09-06 batch D-stage (isolated throwaway profile, npx @deepseek-ai/dsh@0.1.2-rc.1): the standard `dsh plugin --profile web add <tarball>` fails with ERR_PNPM_IGNORED_BUILDS (pnpm 11 ignored-builds environmental gate); the documented compat recipe (pnpm-workspace.yaml allowBuilds preset for dsh-subprocess-local/koffi/node-pty/protobufjs) then installs cleanly - add exit 0 (resolved 381, added 271), dump-config shows the plugin row + bundle layer, keyless headless reaches MISSING_CREDENTIAL (tree-load proof). Reproduction: _scratch/batch-2026-09-06/verify/dsh-auto-review.md"
31
+ }
32
+ },
33
+ "veto": null,
34
+ "notes": "Registry entry refreshed for 0.10.4 (published 2026-09-05 with OIDC provenance). E upgraded from environment-blocked to ok via the documented allowBuilds compat recipe (the same method the repo's compat.yml uses); the bare unattended install still hits pnpm's ignored-builds gate, recorded above. Grade B -> A."
35
+ }
36
+ ]
37
+ }
package/package.json CHANGED
@@ -1,44 +1,55 @@
1
- {
2
- "name": "@perrylink/dsh-cert-mcp",
3
- "version": "0.1.4",
4
- "description": "Read-only MCP server exposing the dsh-plugin-certification registry: certification grades, snapshots and five-dimension evidence for DeepSeek Harness plugins.",
5
- "type": "module",
6
- "license": "Apache-2.0",
7
- "bin": {
8
- "dsh-cert-mcp": "src/index.js"
9
- },
10
- "files": [
11
- "src",
12
- "data",
13
- "README.md",
14
- "LICENSE"
15
- ],
16
- "engines": {
17
- "node": ">=18"
18
- },
19
- "keywords": [
20
- "mcp",
21
- "mcp-server",
22
- "model-context-protocol",
23
- "deepseek-harness",
24
- "dsh-plugin",
25
- "dsh",
26
- "certification",
27
- "supply-chain-security"
28
- ],
29
- "repository": {
30
- "type": "git",
31
- "url": "https://github.com/PerryLink/dsh-cert-mcp.git"
32
- },
33
- "funding": {
34
- "type": "github",
35
- "url": "https://github.com/sponsors/PerryLink"
36
- },
37
- "scripts": {
38
- "test": "node test/smoke.mjs"
39
- },
40
- "mcpName": "io.github.perrylink/dsh-cert",
41
- "publishConfig": {
42
- "access": "public"
43
- }
44
- }
1
+ {
2
+ "name": "@perrylink/dsh-cert-mcp",
3
+ "version": "0.1.6",
4
+ "description": "Read-only MCP server exposing the dsh-plugin-certification registry: certification grades, snapshots and five-dimension evidence for DeepSeek Harness plugins.",
5
+ "type": "module",
6
+ "main": "./src/plugin.js",
7
+ "exports": {
8
+ ".": "./src/plugin.js",
9
+ "./package.json": "./package.json"
10
+ },
11
+ "license": "Apache-2.0",
12
+ "bin": {
13
+ "dsh-cert-mcp": "src/index.js"
14
+ },
15
+ "files": [
16
+ "src",
17
+ "data",
18
+ "cordis.patch.yml",
19
+ "README.md",
20
+ "LICENSE"
21
+ ],
22
+ "engines": {
23
+ "node": ">=18"
24
+ },
25
+ "keywords": [
26
+ "mcp",
27
+ "mcp-server",
28
+ "model-context-protocol",
29
+ "deepseek-harness",
30
+ "dsh-plugin",
31
+ "dsh",
32
+ "certification",
33
+ "supply-chain-security"
34
+ ],
35
+ "repository": {
36
+ "type": "git",
37
+ "url": "https://github.com/PerryLink/dsh-cert-mcp.git"
38
+ },
39
+ "funding": {
40
+ "type": "github",
41
+ "url": "https://github.com/sponsors/PerryLink"
42
+ },
43
+ "scripts": {
44
+ "test": "node test/smoke.mjs"
45
+ },
46
+ "mcpName": "io.github.perrylink/dsh-cert",
47
+ "publishConfig": {
48
+ "access": "public"
49
+ },
50
+ "dsh": {
51
+ "bundle": {
52
+ "patch": "./cordis.patch.yml"
53
+ }
54
+ }
55
+ }
package/src/index.js CHANGED
@@ -1,23 +1,23 @@
1
- #!/usr/bin/env node
2
- // Stdio transport for dsh-cert-mcp: newline-delimited JSON-RPC on stdin/stdout.
3
-
4
- import readline from 'node:readline'
5
- import { handleRequest } from './server.js'
6
-
7
- const rl = readline.createInterface({ input: process.stdin, crlfDelay: Infinity })
8
-
9
- for await (const line of rl) {
10
- if (!line.trim()) continue
11
- let req
12
- try {
13
- req = JSON.parse(line)
14
- } catch {
15
- continue // ignore malformed frames
16
- }
17
- try {
18
- const res = await handleRequest(req)
19
- if (res !== null) process.stdout.write(`${JSON.stringify(res)}\n`)
20
- } catch (error) {
21
- process.stdout.write(`${JSON.stringify({ jsonrpc: '2.0', id: req.id ?? null, error: { code: -32603, message: String(error?.message ?? error) } })}\n`)
22
- }
23
- }
1
+ #!/usr/bin/env node
2
+ // Stdio transport for dsh-cert-mcp: newline-delimited JSON-RPC on stdin/stdout.
3
+
4
+ import readline from 'node:readline'
5
+ import { handleRequest } from './server.js'
6
+
7
+ const rl = readline.createInterface({ input: process.stdin, crlfDelay: Infinity })
8
+
9
+ for await (const line of rl) {
10
+ if (!line.trim()) continue
11
+ let req
12
+ try {
13
+ req = JSON.parse(line)
14
+ } catch {
15
+ continue // ignore malformed frames
16
+ }
17
+ try {
18
+ const res = await handleRequest(req)
19
+ if (res !== null) process.stdout.write(`${JSON.stringify(res)}\n`)
20
+ } catch (error) {
21
+ process.stdout.write(`${JSON.stringify({ jsonrpc: '2.0', id: req.id ?? null, error: { code: -32603, message: String(error?.message ?? error) } })}\n`)
22
+ }
23
+ }
package/src/plugin.js ADDED
@@ -0,0 +1,71 @@
1
+ // src/plugin.js —— DSH bundle host half
2
+ //
3
+ // Loaded through the `cordis.patch.yml` row (package.json `dsh.bundle.patch`)
4
+ // when the package is installed as a DeepSeek Harness bundle:
5
+ //
6
+ // dsh plugin --profile web add @perrylink/dsh-cert-mcp
7
+ //
8
+ // It re-registers the three read-only certification tools on the DSH tool
9
+ // surface, 1:1 backed by the same `handleRequest` used by the stdio server
10
+ // (bin: src/index.js), which keeps working unchanged for any MCP client.
11
+ import { handleRequest } from './server.js'
12
+
13
+ export const name = '@perrylink/dsh-cert-mcp'
14
+
15
+ const TOOLS = [
16
+ {
17
+ name: 'get_certification',
18
+ description: 'Full certification record (grade, snapshot, five dimensions) for owner/repo',
19
+ parameters: {
20
+ type: 'object',
21
+ properties: {
22
+ owner: { type: 'string', description: 'GitHub owner of the plugin repository' },
23
+ repo: { type: 'string', description: 'GitHub repository name' },
24
+ },
25
+ required: ['owner', 'repo'],
26
+ },
27
+ },
28
+ {
29
+ name: 'list_certified',
30
+ description: 'Every entry in the public certification registry',
31
+ parameters: { type: 'object', properties: {} },
32
+ },
33
+ {
34
+ name: 'certification_spec',
35
+ description: 'Spec v1 summary: five dimensions, grade scale, veto rule',
36
+ parameters: { type: 'object', properties: {} },
37
+ },
38
+ ]
39
+
40
+ async function callTool(tool, args) {
41
+ const response = await handleRequest({
42
+ method: 'tools/call',
43
+ params: { name: tool, arguments: args ?? {} },
44
+ })
45
+ const text = response?.result?.content?.[0]?.text
46
+ if (response?.result?.isError) throw new Error(text ?? 'certification lookup failed')
47
+ return text ?? JSON.stringify(response?.result ?? null)
48
+ }
49
+
50
+ export function apply(ctx) {
51
+ const tools = ctx.get('tools')
52
+ if (!tools) return
53
+ for (const tool of TOOLS) {
54
+ ctx.effect(() => tools.register({
55
+ name: tool.name,
56
+ description: tool.description,
57
+ parameters: tool.parameters,
58
+ output: {
59
+ schema: { type: 'string' },
60
+ render(args, value) {
61
+ return [{ type: 'text', text: String(value) }]
62
+ },
63
+ },
64
+ async execute(args) {
65
+ return callTool(tool.name, args)
66
+ },
67
+ }))
68
+ }
69
+ }
70
+
71
+ export default { name, apply }
package/src/server.js CHANGED
@@ -1,140 +1,147 @@
1
- // Pure JSON-RPC core for dsh-cert-mcp. No transport, no side effects beyond
2
- // reading the embedded registry snapshot and optionally refreshing it from
3
- // the public dsh-plugin-certification repository.
4
-
5
- import { readFile } from 'node:fs/promises'
6
-
7
- const PROTOCOL_VERSION = '2024-11-05'
8
- const SERVER_INFO = { name: 'dsh-cert-mcp', version: '0.1.4' }
9
- const REGISTRY_URL = 'https://raw.githubusercontent.com/PerryLink/dsh-plugin-certification/main/data/certified.json'
10
- const REFRESH_MS = 5 * 60 * 1000
11
-
12
- let registry = null
13
- let lastFetch = 0
14
-
15
- const SPEC = `dsh-plugin-certification spec v1 evaluates a DSH plugin on five dimensions:
16
-
17
- A. manifest — dsh.bundle declaration, license, topics/keywords alignment, multi-language READMEs, engines range.
18
- B. buildHygiene — publish allowlist, peerDependencies, local gate chain (typecheck/test/build/verify/pack), CI green.
19
- C. supplyChain — OpenSSF Scorecard score with per-check evidence.
20
- D. releaseIntegrity — npm publish --provenance via Trusted Publishing.
21
- E. installSmoke — real install of the published package into a sandboxed DSH_HOME.
22
-
23
- Grades: A (all five pass), B (E environment-blocked only), C (non-critical dimension failures), D (critical dimension failures), veto overrides everything (severe supply-chain or install defects).`
24
-
25
- async function loadRegistry(force = false) {
26
- if (!registry) {
27
- const dataUrl = new URL('../data/certified.json', import.meta.url)
28
- try {
29
- registry = JSON.parse(await readFile(dataUrl, 'utf8'))
30
- } catch {
31
- registry = { specVersion: 'v1', generatedAt: null, entries: [] }
32
- }
33
- }
34
- if (force || Date.now() - lastFetch > REFRESH_MS) {
35
- try {
36
- const res = await fetch(REGISTRY_URL, {
37
- headers: { 'user-agent': 'dsh-cert-mcp' },
38
- signal: AbortSignal.timeout(10_000),
39
- })
40
- if (res.ok) {
41
- registry = await res.json()
42
- lastFetch = Date.now()
43
- }
44
- } catch {
45
- // keep the embedded snapshot; the registry repo may be unreachable
46
- }
47
- }
48
- return registry
49
- }
50
-
51
- function findEntry(data, owner, repo) {
52
- const key = `${owner}/${repo}`
53
- return data.entries.find((entry) => entry.repo.toLowerCase() === key.toLowerCase()) ?? null
54
- }
55
-
56
- const TOOLS = [
57
- {
58
- name: 'get_certification',
59
- description: 'Return the dsh-plugin-certification record for one DeepSeek Harness plugin repository (grade, snapshot date, five-dimension evidence).',
60
- inputSchema: {
61
- type: 'object',
62
- properties: {
63
- owner: { type: 'string', description: 'GitHub owner, e.g. PerryLink' },
64
- repo: { type: 'string', description: 'GitHub repository name, e.g. dsh-auto-review' },
65
- },
66
- required: ['owner', 'repo'],
67
- },
68
- },
69
- {
70
- name: 'list_certified',
71
- description: 'List every plugin in the public dsh-plugin-certification registry with repo, grade and snapshot date.',
72
- inputSchema: { type: 'object', properties: {} },
73
- },
74
- {
75
- name: 'certification_spec',
76
- description: 'Explain the dsh-plugin-certification spec v1: the five dimensions, the grade scale and the veto rule.',
77
- inputSchema: { type: 'object', properties: {} },
78
- },
79
- ]
80
-
81
- export async function handleRequest(req) {
82
- switch (req.method) {
83
- case 'initialize':
84
- return {
85
- jsonrpc: '2.0',
86
- id: req.id,
87
- result: {
88
- protocolVersion: PROTOCOL_VERSION,
89
- capabilities: { tools: {} },
90
- serverInfo: SERVER_INFO,
91
- },
92
- }
93
- case 'notifications/initialized':
94
- return null
95
- case 'ping':
96
- return { jsonrpc: '2.0', id: req.id, result: {} }
97
- case 'tools/list':
98
- return { jsonrpc: '2.0', id: req.id, result: { tools: TOOLS } }
99
- case 'tools/call': {
100
- const { name, arguments: args } = req.params ?? {}
101
- const tool = TOOLS.find((candidate) => candidate.name === name)
102
- if (!tool) {
103
- return { jsonrpc: '2.0', id: req.id, error: { code: -32602, message: `Unknown tool: ${name}` } }
104
- }
105
- try {
106
- const data = await loadRegistry()
107
- let text
108
- if (name === 'get_certification') {
109
- if (!args || typeof args.owner !== 'string' || typeof args.repo !== 'string') {
110
- throw new Error('owner and repo are required')
111
- }
112
- const entry = findEntry(data, args.owner, args.repo)
113
- text = entry
114
- ? JSON.stringify(entry, null, 2)
115
- : `No certification record for ${args.owner}/${args.repo} in registry snapshot ${data.generatedAt ?? 'unknown'}.`
116
- } else if (name === 'list_certified') {
117
- const list = data.entries.map((entry) => ({ repo: entry.repo, grade: entry.grade, snapshot: entry.snapshot }))
118
- text = JSON.stringify({ specVersion: data.specVersion, generatedAt: data.generatedAt, count: list.length, entries: list }, null, 2)
119
- } else {
120
- text = SPEC
121
- }
122
- return {
123
- jsonrpc: '2.0',
124
- id: req.id,
125
- result: { content: [{ type: 'text', text }] },
126
- }
127
- } catch (error) {
128
- return {
129
- jsonrpc: '2.0',
130
- id: req.id,
131
- result: { content: [{ type: 'text', text: `Error: ${error.message}` }], isError: true },
132
- }
133
- }
134
- }
135
- default:
136
- return { jsonrpc: '2.0', id: req.id, error: { code: -32601, message: `Method not found: ${req.method}` } }
137
- }
138
- }
139
-
140
- export { SERVER_INFO, PROTOCOL_VERSION }
1
+ // Pure JSON-RPC core for dsh-cert-mcp. No transport, no side effects beyond
2
+ // reading the embedded registry snapshot and optionally refreshing it from
3
+ // the public dsh-plugin-certification repository.
4
+
5
+ import { readFile } from 'node:fs/promises'
6
+
7
+ const PROTOCOL_VERSION = '2024-11-05'
8
+ const SERVER_INFO = { name: 'dsh-cert-mcp', version: '0.1.5' }
9
+ const REGISTRY_URL = 'https://raw.githubusercontent.com/PerryLink/dsh-plugin-certification/main/data/certified.json'
10
+ const REFRESH_MS = 5 * 60 * 1000
11
+
12
+ let registry = null
13
+ let lastFetch = 0
14
+
15
+ const SPEC = `dsh-plugin-certification spec v1 evaluates a DSH plugin on five dimensions:
16
+
17
+ A. manifest — dsh.bundle declaration, license, topics/keywords alignment, multi-language READMEs, engines range.
18
+ B. buildHygiene — publish allowlist, peerDependencies, local gate chain (typecheck/test/build/verify/pack), CI green.
19
+ C. supplyChain — OpenSSF Scorecard score with per-check evidence.
20
+ D. releaseIntegrity — npm publish --provenance via Trusted Publishing.
21
+ E. installSmoke — real install of the published package into a sandboxed DSH_HOME.
22
+
23
+ Grades (spec v1 the registry README is the owner of these definitions):
24
+ - A — all five pass (E must be "ok"), no veto hit.
25
+ - B — E passes and at least three of A/B/C/D pass. An E that ends "install-fail" purely because of an unattended-environment gate (e.g. pnpm's interactive approve-builds cannot be confirmed in a sandbox) also keeps B when A–D pass, and records "environment-blocked".
26
+ - C — E passes, the rest incomplete.
27
+ - D any hard gate fails (dsh.bundle missing, no license, malicious pattern hit).
28
+ - Security veto — obfuscated code, credential exfiltration, or surprising install-time behaviour grades D immediately, with the reason published.
29
+ - Environment gates are never recorded as D.
30
+ - Evidence discipline: every score comes from real, reproducible execution; absent evidence is "no-evidence", never a guess.`
31
+
32
+ async function loadRegistry(force = false) {
33
+ if (!registry) {
34
+ const dataUrl = new URL('../data/certified.json', import.meta.url)
35
+ try {
36
+ registry = JSON.parse(await readFile(dataUrl, 'utf8'))
37
+ } catch {
38
+ registry = { specVersion: 'v1', generatedAt: null, entries: [] }
39
+ }
40
+ }
41
+ if (force || Date.now() - lastFetch > REFRESH_MS) {
42
+ try {
43
+ const res = await fetch(REGISTRY_URL, {
44
+ headers: { 'user-agent': 'dsh-cert-mcp' },
45
+ signal: AbortSignal.timeout(10_000),
46
+ })
47
+ if (res.ok) {
48
+ registry = await res.json()
49
+ lastFetch = Date.now()
50
+ }
51
+ } catch {
52
+ // keep the embedded snapshot; the registry repo may be unreachable
53
+ }
54
+ }
55
+ return registry
56
+ }
57
+
58
+ function findEntry(data, owner, repo) {
59
+ const key = `${owner}/${repo}`
60
+ return data.entries.find((entry) => entry.repo.toLowerCase() === key.toLowerCase()) ?? null
61
+ }
62
+
63
+ const TOOLS = [
64
+ {
65
+ name: 'get_certification',
66
+ description: 'Return the dsh-plugin-certification record for one DeepSeek Harness plugin repository (grade, snapshot date, five-dimension evidence).',
67
+ inputSchema: {
68
+ type: 'object',
69
+ properties: {
70
+ owner: { type: 'string', description: 'GitHub owner, e.g. PerryLink' },
71
+ repo: { type: 'string', description: 'GitHub repository name, e.g. dsh-auto-review' },
72
+ },
73
+ required: ['owner', 'repo'],
74
+ },
75
+ },
76
+ {
77
+ name: 'list_certified',
78
+ description: 'List every plugin in the public dsh-plugin-certification registry with repo, grade and snapshot date.',
79
+ inputSchema: { type: 'object', properties: {} },
80
+ },
81
+ {
82
+ name: 'certification_spec',
83
+ description: 'Explain the dsh-plugin-certification spec v1: the five dimensions, the grade scale and the veto rule.',
84
+ inputSchema: { type: 'object', properties: {} },
85
+ },
86
+ ]
87
+
88
+ export async function handleRequest(req) {
89
+ switch (req.method) {
90
+ case 'initialize':
91
+ return {
92
+ jsonrpc: '2.0',
93
+ id: req.id,
94
+ result: {
95
+ protocolVersion: PROTOCOL_VERSION,
96
+ capabilities: { tools: {} },
97
+ serverInfo: SERVER_INFO,
98
+ },
99
+ }
100
+ case 'notifications/initialized':
101
+ return null
102
+ case 'ping':
103
+ return { jsonrpc: '2.0', id: req.id, result: {} }
104
+ case 'tools/list':
105
+ return { jsonrpc: '2.0', id: req.id, result: { tools: TOOLS } }
106
+ case 'tools/call': {
107
+ const { name, arguments: args } = req.params ?? {}
108
+ const tool = TOOLS.find((candidate) => candidate.name === name)
109
+ if (!tool) {
110
+ return { jsonrpc: '2.0', id: req.id, error: { code: -32602, message: `Unknown tool: ${name}` } }
111
+ }
112
+ try {
113
+ const data = await loadRegistry()
114
+ let text
115
+ if (name === 'get_certification') {
116
+ if (!args || typeof args.owner !== 'string' || typeof args.repo !== 'string') {
117
+ throw new Error('owner and repo are required')
118
+ }
119
+ const entry = findEntry(data, args.owner, args.repo)
120
+ text = entry
121
+ ? JSON.stringify(entry, null, 2)
122
+ : `No certification record for ${args.owner}/${args.repo} in registry snapshot ${data.generatedAt ?? 'unknown'}.`
123
+ } else if (name === 'list_certified') {
124
+ const list = data.entries.map((entry) => ({ repo: entry.repo, grade: entry.grade, snapshot: entry.snapshot }))
125
+ text = JSON.stringify({ specVersion: data.specVersion, generatedAt: data.generatedAt, count: list.length, entries: list }, null, 2)
126
+ } else {
127
+ text = SPEC
128
+ }
129
+ return {
130
+ jsonrpc: '2.0',
131
+ id: req.id,
132
+ result: { content: [{ type: 'text', text }] },
133
+ }
134
+ } catch (error) {
135
+ return {
136
+ jsonrpc: '2.0',
137
+ id: req.id,
138
+ result: { content: [{ type: 'text', text: `Error: ${error.message}` }], isError: true },
139
+ }
140
+ }
141
+ }
142
+ default:
143
+ return { jsonrpc: '2.0', id: req.id, error: { code: -32601, message: `Method not found: ${req.method}` } }
144
+ }
145
+ }
146
+
147
+ export { SERVER_INFO, PROTOCOL_VERSION }