@nativemind108/mcp 0.0.0-stage → 1.0.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.
Files changed (83) hide show
  1. package/CHANGELOG.md +5 -0
  2. package/LICENSE +289 -0
  3. package/NOTICE +5 -0
  4. package/README.md +29 -2
  5. package/dist/cjs/catalog.d.ts +21 -0
  6. package/dist/cjs/catalog.js +54 -0
  7. package/dist/cjs/catalog.js.map +1 -0
  8. package/dist/cjs/client.d.ts +59 -0
  9. package/dist/cjs/client.js +107 -0
  10. package/dist/cjs/client.js.map +1 -0
  11. package/dist/cjs/define.d.ts +37 -0
  12. package/dist/cjs/define.js +26 -0
  13. package/dist/cjs/define.js.map +1 -0
  14. package/dist/cjs/feedback.d.ts +21 -0
  15. package/dist/cjs/feedback.js +77 -0
  16. package/dist/cjs/feedback.js.map +1 -0
  17. package/dist/cjs/http.d.ts +15 -0
  18. package/dist/cjs/http.js +192 -0
  19. package/dist/cjs/http.js.map +1 -0
  20. package/dist/cjs/hub.d.ts +42 -0
  21. package/dist/cjs/hub.js +284 -0
  22. package/dist/cjs/hub.js.map +1 -0
  23. package/dist/cjs/index.d.ts +10 -0
  24. package/dist/cjs/index.js +28 -0
  25. package/dist/cjs/index.js.map +1 -0
  26. package/dist/cjs/options.d.ts +119 -0
  27. package/dist/cjs/options.js +3 -0
  28. package/dist/cjs/options.js.map +1 -0
  29. package/dist/cjs/output.d.ts +23 -0
  30. package/dist/cjs/output.js +88 -0
  31. package/dist/cjs/output.js.map +1 -0
  32. package/dist/cjs/package.json +3 -0
  33. package/dist/cjs/service.d.ts +33 -0
  34. package/dist/cjs/service.js +64 -0
  35. package/dist/cjs/service.js.map +1 -0
  36. package/dist/cjs/tools.d.ts +31 -0
  37. package/dist/cjs/tools.js +124 -0
  38. package/dist/cjs/tools.js.map +1 -0
  39. package/dist/esm/catalog.d.ts +22 -0
  40. package/dist/esm/catalog.d.ts.map +1 -0
  41. package/dist/esm/catalog.js +50 -0
  42. package/dist/esm/catalog.js.map +1 -0
  43. package/dist/esm/client.d.ts +60 -0
  44. package/dist/esm/client.d.ts.map +1 -0
  45. package/dist/esm/client.js +102 -0
  46. package/dist/esm/client.js.map +1 -0
  47. package/dist/esm/define.d.ts +38 -0
  48. package/dist/esm/define.d.ts.map +1 -0
  49. package/dist/esm/define.js +22 -0
  50. package/dist/esm/define.js.map +1 -0
  51. package/dist/esm/feedback.d.ts +22 -0
  52. package/dist/esm/feedback.d.ts.map +1 -0
  53. package/dist/esm/feedback.js +73 -0
  54. package/dist/esm/feedback.js.map +1 -0
  55. package/dist/esm/http.d.ts +16 -0
  56. package/dist/esm/http.d.ts.map +1 -0
  57. package/dist/esm/http.js +185 -0
  58. package/dist/esm/http.js.map +1 -0
  59. package/dist/esm/hub.d.ts +43 -0
  60. package/dist/esm/hub.d.ts.map +1 -0
  61. package/dist/esm/hub.js +275 -0
  62. package/dist/esm/hub.js.map +1 -0
  63. package/dist/esm/index.d.ts +11 -0
  64. package/dist/esm/index.d.ts.map +1 -0
  65. package/dist/esm/index.js +12 -0
  66. package/dist/esm/index.js.map +1 -0
  67. package/dist/esm/options.d.ts +120 -0
  68. package/dist/esm/options.d.ts.map +1 -0
  69. package/dist/esm/options.js +2 -0
  70. package/dist/esm/options.js.map +1 -0
  71. package/dist/esm/output.d.ts +24 -0
  72. package/dist/esm/output.d.ts.map +1 -0
  73. package/dist/esm/output.js +79 -0
  74. package/dist/esm/output.js.map +1 -0
  75. package/dist/esm/service.d.ts +34 -0
  76. package/dist/esm/service.d.ts.map +1 -0
  77. package/dist/esm/service.js +60 -0
  78. package/dist/esm/service.js.map +1 -0
  79. package/dist/esm/tools.d.ts +32 -0
  80. package/dist/esm/tools.d.ts.map +1 -0
  81. package/dist/esm/tools.js +118 -0
  82. package/dist/esm/tools.js.map +1 -0
  83. package/package.json +59 -4
package/CHANGELOG.md ADDED
@@ -0,0 +1,5 @@
1
+ # Changelog
2
+
3
+ ## 1.0.0 — unreleased
4
+
5
+ - First release of `@nativemind108/mcp` (SDD `sdd-nativemind-backend-handmade`, 2026-11-14).
package/LICENSE ADDED
@@ -0,0 +1,289 @@
1
+ # ข้อตกลงสิทธิการใช้งาน NativeMindNONC (ประเทศไทย)
2
+
3
+ ### 1. ข้อกำหนดทั่วไป
4
+
5
+ ข้อตกลงนี้อยู่ภายใต้บังคับของพระราชบัญญัติลิขสิทธิ์ พ.ศ. 2537 และแก้ไขเพิ่มเติม รวมถึงประมวลกฎหมายแพ่งและพาณิชย์แห่งราชอาณาจักรไทย
6
+
7
+ ผู้ถือลิขสิทธิ์: บริษัทผู้พัฒนาซอฟต์แวร์
8
+
9
+ เครื่องหมายการค้าของผลิตภัณฑ์ได้รับการจดทะเบียนและถือครองโดยผู้ถือลิขสิทธิ์
10
+
11
+ ลิขสิทธิ์ © 2010-2025 ผู้ถือลิขสิทธิ์ สงวนลิขสิทธิ์
12
+
13
+ ### 2. เงื่อนไขการใช้งาน
14
+
15
+ การใช้งานโปรแกรมซอฟต์แวร์ ("ผลิตภัณฑ์") ถือว่าท่านยอมรับข้อกำหนดและเงื่อนไขตามข้อตกลงฉบับนี้ หากท่านไม่ยอมรับ โปรดหยุดใช้งานผลิตภัณฑ์โดยทันที
16
+
17
+ #### 2.1. การเผยแพร่ซอร์สโค้ด
18
+
19
+ เมื่อท่านใช้งานซอร์สโค้ดของผลิตภัณฑ์ ท่านมีหน้าที่:
20
+
21
+ - เผยแพร่ซอร์สโค้ดของท่านผ่าน GitHub โดยทำเป็น Fork ของ Repository อย่างเป็นทางการ
22
+ - ปรับปรุงให้เป็นปัจจุบันอยู่เสมอเพื่อสะท้อนการเปลี่ยนแปลงจากต้นฉบับ
23
+ - ระบุให้ชัดเจนว่าซอร์สโค้ดของท่านเป็น Fork ของ Repository ดั้งเดิม
24
+
25
+ #### 2.2. การเผยแพร่อัตโนมัติ
26
+
27
+ การเผยแพร่ทุกครั้งต้องดำเนินการผ่าน GitHub Actions เท่านั้น
28
+
29
+ #### 2.3. การให้เครดิต (Attribution)
30
+
31
+ เมื่อเผยแพร่ผลิตภัณฑ์ที่ดัดแปลงจากผลิตภัณฑ์ต้นฉบับ ท่านต้อง:
32
+
33
+ - ระบุเครดิตของผู้ถือลิขสิทธิ์พร้อมลิงก์ไปที่ Repository ดั้งเดิม
34
+ - แสดงลิงก์ไปยังข้อตกลงสิทธิ์ดั้งเดิม
35
+ - บันทึกการเปลี่ยนแปลงใน README ของ Repository ของท่าน
36
+
37
+ #### 2.4. ห้ามการใส่มัลแวร์
38
+
39
+ ห้ามอย่างเด็ดขาดที่จะเพิ่มมัลแวร์หรือรหัสอันตรายใด ๆ ลงในผลิตภัณฑ์
40
+
41
+ #### 2.5. ข้อจำกัดการใช้ชื่อและอินเทอร์เฟซ
42
+
43
+ ห้ามเผยแพร่แอปพลิเคชันในร้านค้าแอปใดๆ เช่น Google Play, App Store, F-Droid, Microsoft Store, Huawei AppGallery หรือแพลตฟอร์มอื่นใดด้วยชื่อหรือหน้าตาที่คล้ายกับผลิตภัณฑ์ต้นฉบับจนอาจทำให้เกิดความเข้าใจผิด
44
+
45
+ #### 2.6. การใช้งานเชิงพาณิชย์
46
+
47
+ **ฟรีสำหรับการใช้งานที่ไม่ใช่เชิงพาณิชย์**: ผลิตภัณฑ์นี้ฟรีสำหรับการใช้งานที่ไม่ใช่เชิงพาณิชย์ รวมถึง:
48
+ - สถาบันการศึกษา (โรงเรียน มหาวิทยาลัย วิทยาลัย)
49
+ - วัตถุประสงค์ทางการศึกษาและการฝึกอบรม
50
+ - การวิจัยและพัฒนาสำหรับโครงการที่ไม่ใช่เชิงพาณิชย์
51
+ - การเรียนรู้และการพัฒนาส่วนบุคคล
52
+
53
+ **การใช้งานเชิงพาณิชย์ต้องมีใบอนุญาต**: การใช้งานเชิงพาณิชย์ของผลิตภัณฑ์นี้ต้องได้รับอนุญาตเป็นลายลักษณ์อักษรจากผู้ถือลิขสิทธิ์ก่อนดำเนินการเชิงพาณิชย์ใดๆ รวมถึง:
54
+ - การขายหรือจำหน่ายเพื่อหากำไร
55
+ - การใช้งานในผลิตภัณฑ์หรือบริการเชิงพาณิชย์
56
+ - แอปพลิเคชันทางธุรกิจ
57
+ - กิจกรรมใดๆ ที่สร้างรายได้
58
+
59
+ #### 2.7. สิทธิของนักพัฒนาและโครงสร้างบริษัท
60
+
61
+ สิทธิทั้งหมดเป็นของนักพัฒนาที่เฉพาะเจาะจงซึ่งเป็นส่วนหนึ่งของบริษัทที่พัฒนาซอฟต์แวร์นี้ นักพัฒนาอาจ:
62
+ - นำเสนอโค้ดและผลงานในงานแสดงสินค้าและงานประชุม
63
+ - แสดงความสำเร็จทางเทคนิคของตนต่อสาธารณะ
64
+ - ใช้ผลงานของตนเพื่อพอร์ตโฟลิโอทางวิชาชีพและการพัฒนาอาชีพ
65
+
66
+ อย่างไรก็ตาม นักพัฒนาไม่สามารถ:
67
+ - ใช้โค้ดหรือผลงานเพื่อวัตถุประสงค์เชิงพาณิชย์ส่วนตัว
68
+ - อนุญาตให้ใช้ซอฟต์แวร์อย่างอิสระนอกเหนือจากโครงสร้างบริษัท
69
+ - โอนสิทธิเชิงพาณิชย์โดยไม่ได้รับอนุญาตจากบริษัท
70
+
71
+ การอนุญาตเชิงพาณิชย์ทั้งหมดต้องดำเนินการผ่านบริษัทที่จ้างนักพัฒนาเหล่านี้
72
+
73
+ #### 2.8. การเผยแพร่ภายใต้เงื่อนไขเดียวกัน (ShareAlike)
74
+
75
+ ผลงานที่สร้างจากผลิตภัณฑ์นี้ต้องถูกเผยแพร่ภายใต้ข้อตกลงสิทธิ์เดียวกันและในรูปแบบ Open Source ผ่านการ Fork จาก Repository ดั้งเดิม
76
+
77
+ ### 3. การใช้งานส่วนประกอบ Open Source
78
+
79
+ ผลิตภัณฑ์ประกอบด้วยส่วนประกอบ Open Source ที่ได้รับอนุญาตตามเงื่อนไขอื่นๆ การใช้งานผลิตภัณฑ์หมายถึงท่านยอมรับเงื่อนไขของแต่ละส่วนประกอบด้วย รายละเอียดระบุไว้ในไฟล์ LICENSE.md ที่แนบมาพร้อมผลิตภัณฑ์
80
+
81
+ ### 4. การปฏิเสธความรับผิด
82
+
83
+ ผลิตภัณฑ์นี้ให้บริการ "ตามสภาพ" โดยไม่มีการรับประกันใดๆ ทั้งสิ้น ไม่ว่าจะแจ้งชัดหรือโดยนัย รวมถึงการรับประกันด้านความเหมาะสมกับวัตถุประสงค์เฉพาะใดๆ และผู้ถือลิขสิทธิ์จะไม่รับผิดชอบต่อความเสียหายใดๆ อันเกิดจากการใช้งานผลิตภัณฑ์นี้
84
+
85
+ ### 5. การละเมิดข้อตกลง
86
+
87
+ ในกรณีที่มีการละเมิดข้อตกลงนี้ ผู้ถือลิขสิทธิ์มีสิทธิ์ขอให้หยุดเผยแพร่ผลิตภัณฑ์ และอาจดำเนินการทางกฎหมายหรือแจ้งไปยังร้านค้าแอปพลิเคชันเพื่อให้มีการลบหรือระงับการเผยแพร่ผลิตภัณฑ์ที่ละเมิด
88
+
89
+ ข้อพิพาทใดๆ จะต้องได้รับการตัดสินตามกฎหมายแห่งราชอาณาจักรไทย
90
+
91
+ ---
92
+
93
+ การใช้งานผลิตภัณฑ์หมายถึงท่านได้อ่าน เข้าใจ และยอมรับข้อกำหนดและเงื่อนไขทั้งหมดตามข้อตกลงนี้แล้ว
94
+
95
+ ---
96
+
97
+ ## Лицензионное соглашение (Российская Федерация)
98
+
99
+ ### 1. Общие положения
100
+
101
+ Настоящая лицензия регулируется нормами Гражданского кодекса Российской Федерации (часть IV, статьи 1225-1301) и иных применимых законодательных актов РФ.
102
+
103
+ Правообладатель: Компания-разработчик программного обеспечения
104
+
105
+ Товарный знак продукта зарегистрирован и принадлежит правообладателю.
106
+
107
+ © 2010-2025 Правообладатель. Все права защищены.
108
+
109
+ ### 2. Условия использования
110
+
111
+ Используя программный продукт ("Продукт"), вы подтверждаете согласие с условиями настоящей лицензии. В случае несогласия вы обязаны немедленно прекратить использование и распространение Продукта.
112
+
113
+ #### 2.1. Доступность исходного кода
114
+
115
+ При использовании исходного кода Продукта вы обязаны:
116
+
117
+ - Опубликовать производный код исключительно в виде публичного репозитория на платформе GitHub в виде форка официального репозитория
118
+ - Своевременно обновлять свой репозиторий, отражая изменения в официальных релизах
119
+ - Указывать в репозитории, что он является форком официального репозитория
120
+
121
+ #### 2.2. Автоматизация релизов
122
+
123
+ Все релизы Продукта должны осуществляться исключительно через GitHub Actions.
124
+
125
+ #### 2.3. Обязательная атрибуция
126
+
127
+ При распространении производного Продукта вы обязаны:
128
+
129
+ - Указывать автора и давать соответствующую ссылку на официальный репозиторий
130
+ - Размещать ссылку на оригинальную лицензию
131
+ - Документировать изменения, сделанные вами в README вашего репозитория
132
+
133
+ #### 2.4. Запрет вредоносного ПО
134
+
135
+ Категорически запрещается встраивать любое вредоносное программное обеспечение (вирусы, трояны и т.п.).
136
+
137
+ #### 2.5. Ограничения на использование имени и интерфейса
138
+
139
+ Запрещается публикация производных продуктов под названием или с пользовательским интерфейсом, сходным до степени смешения с оригинальным продуктом, на любых площадках распространения программного обеспечения (например, Google Play, App Store, RuStore, NashStore, AppGallery, VK Play и других площадках).
140
+
141
+ #### 2.6. Некоммерческое использование
142
+
143
+ **Бесплатно для некоммерческого использования**: Данный продукт бесплатен для некоммерческого использования, включая:
144
+ - Образовательные учреждения (школы, университеты, колледжи)
145
+ - Образовательные и обучающие цели
146
+ - Исследования и разработки для некоммерческих проектов
147
+ - Личное обучение и развитие
148
+
149
+ **Коммерческое использование требует лицензии**: Использование Продукта в коммерческих целях (продажа, реклама, иные коммерческие операции) допускается исключительно после письменного согласия правообладателя.
150
+
151
+ #### 2.7. Права разработчиков и структура компании
152
+
153
+ Все права принадлежат конкретным разработчикам, которые входят в состав компании, разрабатывающей данное программное обеспечение. Разработчики могут:
154
+ - Представлять код и результаты работы на выставках и конференциях
155
+ - Демонстрировать свои технические достижения публично
156
+ - Использовать свою работу для профессионального портфолио и развития карьеры
157
+
158
+ Однако разработчики не могут:
159
+ - Использовать код или результаты работы для личных коммерческих целей
160
+ - Лицензировать программное обеспечение независимо вне структуры компании
161
+ - Передавать коммерческие права без разрешения компании
162
+
163
+ Все коммерческое лицензирование должно проводиться через компанию, которая нанимает этих разработчиков.
164
+
165
+ #### 2.8. Условие аналогичного распространения (ShareAlike)
166
+
167
+ Любое изменение, адаптация или создание производных работ на основе Продукта должно распространяться исключительно на условиях настоящей лицензии и с открытым исходным кодом через форк официального репозитория.
168
+
169
+ ### 3. Использование компонентов с открытым исходным кодом
170
+
171
+ Продукт содержит компоненты с открытым исходным кодом, лицензируемые отдельно. Пользуясь Продуктом, вы принимаете условия лицензий каждого компонента. Подробности указаны в файле LICENSE.md, входящем в комплект поставки.
172
+
173
+ ### 4. Ответственность сторон
174
+
175
+ Продукт предоставляется «как есть», без каких-либо гарантий, явных или подразумеваемых, в том числе гарантий пригодности для определённых целей и отсутствия нарушений прав третьих лиц. Правообладатель не несёт ответственности за убытки, возникающие вследствие использования или невозможности использования Продукта.
176
+
177
+ ### 5. Нарушение условий лицензии
178
+
179
+ При нарушении условий настоящей лицензии правообладатель вправе требовать прекращения распространения Продукта, а также обратиться в суд или обратиться с жалобой в соответствующие площадки распространения программного обеспечения для удаления или ограничения доступа к нарушающим продуктам.
180
+
181
+ Споры разрешаются в порядке, установленном законодательством Российской Федерации.
182
+
183
+ ---
184
+
185
+ Используя Продукт, вы подтверждаете, что прочитали, поняли и полностью принимаете условия настоящей лицензии.
186
+
187
+ ---
188
+
189
+ ## License Agreement (English)
190
+
191
+ ### 1. General Provisions
192
+
193
+ This agreement is governed by copyright laws and intellectual property regulations of the jurisdiction where the software is used.
194
+
195
+ Copyright Holder: Software Development Company
196
+
197
+ The product trademark is registered and owned by the copyright holder.
198
+
199
+ Copyright © 2010-2025 Copyright Holder. All rights reserved.
200
+
201
+ ### 2. Usage Terms
202
+
203
+ By using the software product ("Product"), you agree to accept the terms and conditions of this agreement. If you do not agree, please stop using the product immediately.
204
+
205
+ #### 2.1. Source Code Publication
206
+
207
+ When using the source code of the Product, you are obligated to:
208
+
209
+ - Publish your source code through GitHub by creating a Fork of the official Repository
210
+ - Keep it updated to reflect changes from the original
211
+ - Clearly indicate that your source code is a Fork of the original Repository
212
+
213
+ #### 2.2. Automatic Publication
214
+
215
+ All publications must be conducted through GitHub Actions only.
216
+
217
+ #### 2.3. Attribution
218
+
219
+ When publishing products derived from the original Product, you must:
220
+
221
+ - Credit the copyright holder with a link to the original Repository
222
+ - Display a link to the original license agreement
223
+ - Record changes in the README of your Repository
224
+
225
+ #### 2.4. Malware Prohibition
226
+
227
+ It is strictly prohibited to add malware or any dangerous code to the product.
228
+
229
+ #### 2.5. Name and Interface Usage Restrictions
230
+
231
+ It is prohibited to publish applications in any app store (Google Play, App Store, F-Droid, Microsoft Store, Huawei AppGallery, or other platforms) with names or interfaces similar to the original product that may cause confusion.
232
+
233
+ #### 2.6. Commercial Use
234
+
235
+ **Free for Non-Commercial Use**: This product is free for non-commercial use including:
236
+ - Educational institutions (schools, universities, colleges)
237
+ - Educational and training purposes
238
+ - Research and development for non-commercial projects
239
+ - Personal learning and development
240
+
241
+ **Commercial Use Requires License**: Commercial use of this product requires a written license agreement from the copyright holder before any commercial activities including:
242
+ - Selling or distributing for profit
243
+ - Using in commercial products or services
244
+ - Business applications
245
+ - Any revenue-generating activities
246
+
247
+ #### 2.7. Developer Rights and Company Structure
248
+
249
+ All rights belong to specific developers who are part of the company that develops this software. Developers may:
250
+ - Present code and work results at exhibitions and conferences
251
+ - Showcase their technical achievements publicly
252
+ - Use their work for professional portfolio and career development
253
+
254
+ However, developers cannot:
255
+ - Use the code or work results for personal commercial purposes
256
+ - License the software independently outside the company structure
257
+ - Transfer commercial rights without company authorization
258
+
259
+ All commercial licensing must be conducted through the company that employs these developers.
260
+
261
+ #### 2.8. License Standardization
262
+
263
+ This license may become a standard and other companies may copy the license text for their own use, similar to MIT, Apache, or GPL licenses.
264
+
265
+ #### 2.9. ShareAlike Requirement
266
+
267
+ Any work created from this product must be published under the same license terms and in open source format through a Fork from the original Repository.
268
+
269
+ ### 3. Open Source Components
270
+
271
+ The Product includes Open Source components licensed under different terms. Using the Product means you accept the terms of each component as well. Details are specified in the LICENSE.md file included with the product.
272
+
273
+ ### 4. Disclaimer
274
+
275
+ This product is provided "as is" without any warranties, whether express or implied, including warranties of merchantability, fitness for a particular purpose, and non-infringement. The copyright holder shall not be liable for any damages arising from the use of this product.
276
+
277
+ ### 5. License Violations
278
+
279
+ In case of violation of this agreement, the copyright holder has the right to request cessation of product distribution and may take legal action or notify app stores to remove or suspend distribution of violating products.
280
+
281
+ Any disputes shall be resolved according to the laws of the jurisdiction where the copyright holder is incorporated.
282
+
283
+ ---
284
+
285
+ Using the Product means you have read, understood, and accepted all terms and conditions of this agreement.
286
+
287
+ ---
288
+
289
+ # NativeMindNONC License Agreement
package/NOTICE ADDED
@@ -0,0 +1,5 @@
1
+ @nativemind108/mcp
2
+ Copyright (c) NativeMind. Licensed under the NativeMindNONC License (see LICENSE).
3
+
4
+ Hand-written code by people is marked in the source with "written by <Author> (without AI), <date>".
5
+ Code written with AI tools is marked "generated by <tool> (<model>), <date>".
package/README.md CHANGED
@@ -1,3 +1,30 @@
1
- # Temporary Holding Version
1
+ # @nativemind108/mcp
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ The MCP server of a NativeMind product as a **separate service**. It never touches a database: it calls the product API over
4
+ HTTP with the caller's bearer (`X-NM-Client: mcp`). Streamable HTTP (with RFC 9728 OAuth metadata) or stdio; optional legacy
5
+ HTTP+SSE.
6
+
7
+ Tools come from three places:
8
+
9
+ 1. **The API catalog** — `GET {basePath}/meta/operations?mcpOnly=true` (see `@nativemind108/api` `catalogOperation`), refreshed
10
+ every minute; `tools/list_changed` when the key policy changes.
11
+ 2. **Hand-written tools** of the product — `defineTool({ name, input: { …zod… }, call: (args, { api }) => api.request(…) })`.
12
+ 3. **Feedback tools**, always on: `report_bug`, `suggest_improvement`, `leave_review`, `add_feedback_note`, `my_feedback`.
13
+
14
+ ```ts
15
+ import { mcpConfigFromEnv, startMcpService } from '@nativemind108/mcp';
16
+
17
+ const cfg = mcpConfigFromEnv(process.env, process.argv.slice(2), { prefix: 'DX_MCP' }); // NM_MCP_* (+ old DX_MCP_* names)
18
+ await startMcpService({
19
+ product: { name: 'demo-mcp', title: 'Demo', instructions: 'Demo tools …' },
20
+ api: { url: cfg.apiUrl, basePath: '/v1' },
21
+ transports: cfg.http ? { http: { ...cfg.http, publicUrl: cfg.publicUrl, authServers: cfg.authServers } } : { stdio: { apiKey: cfg.apiKey } },
22
+ catalog: { enabled: true, toolsets: cfg.toolsets, jobs: { path: '/v1/jobs' } },
23
+ limits: { maxRows: cfg.maxRows, maxBytes: cfg.maxBytes },
24
+ });
25
+ ```
26
+
27
+ Environment: `NM_MCP_API_URL`, `NM_MCP_TRANSPORT=http` (or `--http`), `NM_MCP_HTTP_HOST`, `NM_MCP_HTTP_PORT`, `NM_MCP_PUBLIC_URL`,
28
+ `NM_MCP_AUTH_SERVER`, `NM_MCP_API_KEY` (stdio), `NM_MCP_TOOLSETS`, `NM_MCP_MAX_ROWS`, `NM_MCP_MAX_BYTES`, `NM_MCP_REFRESH_MS`.
29
+
30
+ License: NativeMindNONC (see LICENSE).
@@ -0,0 +1,21 @@
1
+ import type { ApiClient, CatalogOperation } from './client.js';
2
+ /**
3
+ * The operations one key may use over MCP: the API catalog (already filtered by the key policy) narrowed by the
4
+ * configured toolsets, without 501 stubs. `refresh()` reports whether the set changed (→ tools/list_changed).
5
+ */
6
+ export declare class Catalog {
7
+ private readonly client;
8
+ private readonly toolsets;
9
+ private ops;
10
+ private fingerprint;
11
+ private loaded;
12
+ private inflight;
13
+ /** Epoch ms of the last successful fetch (0 = never). */
14
+ loadedAt: number;
15
+ constructor(client: ApiClient, toolsets: Set<string> | null);
16
+ get operations(): CatalogOperation[];
17
+ get isLoaded(): boolean;
18
+ byToolName(name: string): CatalogOperation | undefined;
19
+ /** Re-reads the catalog; resolves true when the exposed operation set changed. Concurrent calls share one fetch. */
20
+ refresh(): Promise<boolean>;
21
+ }
@@ -0,0 +1,54 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.Catalog = void 0;
4
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade (from dropexpired services/mcp/src/catalog.ts)
5
+ /**
6
+ * The operations one key may use over MCP: the API catalog (already filtered by the key policy) narrowed by the
7
+ * configured toolsets, without 501 stubs. `refresh()` reports whether the set changed (→ tools/list_changed).
8
+ */
9
+ class Catalog {
10
+ client;
11
+ toolsets;
12
+ ops = [];
13
+ fingerprint = '';
14
+ loaded = false;
15
+ inflight = null;
16
+ /** Epoch ms of the last successful fetch (0 = never). */
17
+ loadedAt = 0;
18
+ constructor(client, toolsets) {
19
+ this.client = client;
20
+ this.toolsets = toolsets;
21
+ }
22
+ get operations() {
23
+ return this.ops;
24
+ }
25
+ get isLoaded() {
26
+ return this.loaded;
27
+ }
28
+ byToolName(name) {
29
+ return this.ops.find((op) => op.mcp?.name === name);
30
+ }
31
+ /** Re-reads the catalog; resolves true when the exposed operation set changed. Concurrent calls share one fetch. */
32
+ refresh() {
33
+ this.inflight ??= (async () => {
34
+ try {
35
+ const all = await this.client.catalog();
36
+ const next = all.filter((op) => op.mcp && op.rest && op.implemented !== false && (!this.toolsets || this.toolsets.has(op.toolset)));
37
+ next.sort((a, b) => a.id.localeCompare(b.id));
38
+ const fingerprint = next.map((op) => `${op.id}:${op.safety}`).join('|');
39
+ const changed = this.loaded && fingerprint !== this.fingerprint;
40
+ this.ops = next;
41
+ this.fingerprint = fingerprint;
42
+ this.loaded = true;
43
+ this.loadedAt = Date.now();
44
+ return changed;
45
+ }
46
+ finally {
47
+ this.inflight = null;
48
+ }
49
+ })();
50
+ return this.inflight;
51
+ }
52
+ }
53
+ exports.Catalog = Catalog;
54
+ //# sourceMappingURL=catalog.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/catalog.ts"],"names":[],"mappings":";;;AAEA,iIAAiI;AACjI;;;GAGG;AACH,MAAa,OAAO;IAQW;IAAoC;IAPzD,GAAG,GAAuB,EAAE,CAAC;IAC7B,WAAW,GAAG,EAAE,CAAC;IACjB,MAAM,GAAG,KAAK,CAAC;IACf,QAAQ,GAA4B,IAAI,CAAC;IACjD,yDAAyD;IACzD,QAAQ,GAAG,CAAC,CAAC;IAEb,YAA6B,MAAiB,EAAmB,QAA4B;QAAhE,WAAM,GAAN,MAAM,CAAW;QAAmB,aAAQ,GAAR,QAAQ,CAAoB;IAAG,CAAC;IAEjG,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,oHAAoH;IACpH,OAAO;QACL,IAAI,CAAC,QAAQ,KAAK,CAAC,KAAK,IAAI,EAAE;YAC5B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACxC,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,KAAK,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBACpI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACxE,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,IAAI,WAAW,KAAK,IAAI,CAAC,WAAW,CAAC;gBAChE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;gBAChB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;gBAC/B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;gBACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC3B,OAAO,OAAO,CAAC;YACjB,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACvB,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF;AA1CD,0BA0CC"}
@@ -0,0 +1,59 @@
1
+ import type { CatalogOperation } from '@nativemind108/api';
2
+ export type { CatalogOperation } from "@nativemind108/api";
3
+ export interface ApiEnvelope<T = unknown> {
4
+ data: T;
5
+ meta?: {
6
+ requestId?: string;
7
+ page?: {
8
+ nextCursor: string | null;
9
+ hasMore?: boolean;
10
+ total?: number;
11
+ totalEstimate?: number;
12
+ };
13
+ refresh?: {
14
+ id: string;
15
+ status: string;
16
+ kinds?: string[];
17
+ eta?: string | null;
18
+ reason?: string;
19
+ };
20
+ [extra: string]: unknown;
21
+ };
22
+ }
23
+ export declare class ApiCallError extends Error {
24
+ readonly status: number;
25
+ readonly code: string;
26
+ readonly details: unknown;
27
+ readonly preview?: unknown | undefined;
28
+ readonly requestId?: string | undefined;
29
+ constructor(status: number, code: string, message: string, details?: unknown, preview?: unknown | undefined, requestId?: string | undefined);
30
+ }
31
+ export interface ApiClientOptions {
32
+ /** Prefix of catalog and generic paths ('/v1', '/api/v1', '/api'). */
33
+ basePath: string;
34
+ /** Headers marking the MCP service as the caller (default `X-NM-Client: mcp`; dx adds `X-DX-Client: mcp`). */
35
+ clientHeaders?: Record<string, string>;
36
+ userAgent?: string;
37
+ fetch?: typeof fetch;
38
+ /** Request timeout, ms (default 60 s). */
39
+ timeoutMs?: number;
40
+ }
41
+ /** Thin REST client of the product API (`{data, meta}` / `{error}`); every request carries the caller's bearer. */
42
+ export declare class ApiClient {
43
+ readonly baseUrl: string;
44
+ private apiKey;
45
+ readonly options: ApiClientOptions;
46
+ private extra;
47
+ constructor(baseUrl: string, apiKey: string | null, options: ApiClientOptions);
48
+ /** OAuth access tokens rotate: a session of the same grant continues with the new token. */
49
+ setKey(apiKey: string | null): void;
50
+ /** Headers added to every request of this client (e.g. X-NM-MCP-Client of the session). */
51
+ setHeaders(headers: Record<string, string>): void;
52
+ get basePath(): string;
53
+ request<T = unknown>(method: string, path: string, args?: Record<string, unknown>, headers?: Record<string, string>): Promise<{
54
+ status: number;
55
+ body: ApiEnvelope<T>;
56
+ headers: Headers;
57
+ }>;
58
+ catalog(): Promise<CatalogOperation[]>;
59
+ }
@@ -0,0 +1,107 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.ApiClient = exports.ApiCallError = void 0;
4
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade
5
+ class ApiCallError extends Error {
6
+ status;
7
+ code;
8
+ details;
9
+ preview;
10
+ requestId;
11
+ constructor(status, code, message, details = [], preview, requestId) {
12
+ super(message);
13
+ this.status = status;
14
+ this.code = code;
15
+ this.details = details;
16
+ this.preview = preview;
17
+ this.requestId = requestId;
18
+ this.name = 'ApiCallError';
19
+ }
20
+ }
21
+ exports.ApiCallError = ApiCallError;
22
+ /** `filter: {tf: {gte: 5}}` → `filter[tf][gte]=5` (the REST list convention). */
23
+ function appendQuery(qs, key, value) {
24
+ if (value === undefined || value === null)
25
+ return;
26
+ if (Array.isArray(value))
27
+ qs.append(key, value.map(String).join(','));
28
+ else if (typeof value === 'object')
29
+ for (const [k, v] of Object.entries(value))
30
+ appendQuery(qs, `${key}[${k}]`, v);
31
+ else
32
+ qs.append(key, String(value));
33
+ }
34
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade
35
+ /** Thin REST client of the product API (`{data, meta}` / `{error}`); every request carries the caller's bearer. */
36
+ class ApiClient {
37
+ baseUrl;
38
+ apiKey;
39
+ options;
40
+ extra = {};
41
+ constructor(baseUrl, apiKey, options) {
42
+ this.baseUrl = baseUrl;
43
+ this.apiKey = apiKey;
44
+ this.options = options;
45
+ }
46
+ /** OAuth access tokens rotate: a session of the same grant continues with the new token. */
47
+ setKey(apiKey) {
48
+ this.apiKey = apiKey;
49
+ }
50
+ /** Headers added to every request of this client (e.g. X-NM-MCP-Client of the session). */
51
+ setHeaders(headers) {
52
+ this.extra = { ...this.extra, ...headers };
53
+ }
54
+ get basePath() {
55
+ return this.options.basePath;
56
+ }
57
+ async request(method, path, args = {}, headers = {}) {
58
+ const rest = { ...args };
59
+ const url = path.replace(/\{([A-Za-z0-9_]+)\}/g, (_m, name) => {
60
+ const value = rest[name];
61
+ if (value === undefined || value === null || value === '')
62
+ throw new ApiCallError(400, 'VALIDATION_ERROR', `Missing path parameter "${name}".`, [{ field: name, reason: 'is required' }]);
63
+ delete rest[name];
64
+ return encodeURIComponent(String(value));
65
+ });
66
+ const upper = method.toUpperCase();
67
+ const withBody = upper === 'POST' || upper === 'PUT' || upper === 'PATCH' || (upper === 'DELETE' && Object.keys(rest).length > 0);
68
+ const qs = new URLSearchParams();
69
+ if (!withBody)
70
+ for (const [k, v] of Object.entries(rest))
71
+ appendQuery(qs, k, v);
72
+ const query = qs.toString();
73
+ const res = await (this.options.fetch ?? fetch)(`${this.baseUrl}${url}${query ? `?${query}` : ''}`, {
74
+ method: upper,
75
+ signal: AbortSignal.timeout(this.options.timeoutMs ?? 60_000),
76
+ headers: {
77
+ ...(this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}),
78
+ Accept: 'application/json',
79
+ 'User-Agent': this.options.userAgent ?? 'nativemind-mcp/1',
80
+ ...(this.options.clientHeaders ?? { 'X-NM-Client': 'mcp' }),
81
+ ...this.extra,
82
+ ...headers,
83
+ ...(withBody ? { 'Content-Type': 'application/json' } : {}),
84
+ },
85
+ ...(withBody ? { body: JSON.stringify(rest) } : {}),
86
+ });
87
+ const text = await res.text();
88
+ let body = null;
89
+ try {
90
+ body = text ? JSON.parse(text) : null;
91
+ }
92
+ catch {
93
+ body = { raw: text };
94
+ }
95
+ if (!res.ok) {
96
+ const err = body?.error;
97
+ throw new ApiCallError(res.status, err?.code ?? `HTTP_${res.status}`, err?.message ?? `API answered ${res.status}.`, err?.details ?? [], err?.preview, err?.requestId);
98
+ }
99
+ return { status: res.status, body: (body ?? { data: null }), headers: res.headers };
100
+ }
101
+ async catalog() {
102
+ const res = await this.request('GET', `${this.options.basePath}/meta/operations`, { mcpOnly: true });
103
+ return res.body.data.operations;
104
+ }
105
+ }
106
+ exports.ApiClient = ApiClient;
107
+ //# sourceMappingURL=client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,37 @@
1
+ import { z, type ZodRawShape } from 'zod';
2
+ import type { CallToolResult, Tool } from '@modelcontextprotocol/sdk/types.js';
3
+ import type { ApiClient } from './client.js';
4
+ /** What a hand-written tool receives on a call. */
5
+ export interface ToolCallContext {
6
+ /** API client of the session (the caller's bearer, X-NM-Client: mcp). */
7
+ api: ApiClient;
8
+ /** Route params of the MCP endpoint (Konsilium: `{ projectId }` of /mcp/p/:projectId). */
9
+ params: Record<string, string>;
10
+ /** Language of the session (?lang= or the product's resolver). */
11
+ lang: string | null;
12
+ /** `name version` of the MCP client (initialize clientInfo). */
13
+ client: string;
14
+ /** Product data attached to the route / session. */
15
+ extra: Record<string, unknown>;
16
+ }
17
+ /** A hand-written tool (product tools, feedback tools). The handler returns plain data (wrapped as `{data}`) or a CallToolResult. */
18
+ export interface ToolDefinition {
19
+ name: string;
20
+ title: string;
21
+ description: string;
22
+ inputSchema: Tool['inputSchema'];
23
+ annotations?: Tool['annotations'];
24
+ /** Parses / validates raw arguments (zod tools); throws ZodError on bad input. */
25
+ parse?: (args: unknown) => unknown;
26
+ call: (args: any, ctx: ToolCallContext) => Promise<unknown>;
27
+ }
28
+ export declare function isCallToolResult(value: unknown): value is CallToolResult;
29
+ /** A tool with a zod input shape (as Konsilium's `server.registerTool`); JSON Schema for tools/list via z.toJSONSchema. */
30
+ export declare function defineTool<S extends ZodRawShape>(def: {
31
+ name: string;
32
+ title: string;
33
+ description: string;
34
+ input: S;
35
+ annotations?: Tool['annotations'];
36
+ call: (args: z.infer<z.ZodObject<S>>, ctx: ToolCallContext) => Promise<unknown>;
37
+ }): ToolDefinition;