@mokoconsulting/mcp-windows 3.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 (184) hide show
  1. package/.gitattributes +94 -0
  2. package/.gitmessage +9 -0
  3. package/.mokogitea/ISSUE_TEMPLATE/adr.md +110 -0
  4. package/.mokogitea/ISSUE_TEMPLATE/bug_report.md +48 -0
  5. package/.mokogitea/ISSUE_TEMPLATE/config.yml +18 -0
  6. package/.mokogitea/ISSUE_TEMPLATE/documentation.md +52 -0
  7. package/.mokogitea/ISSUE_TEMPLATE/feature_request.md +51 -0
  8. package/.mokogitea/ISSUE_TEMPLATE/mcp_api_integration.md +48 -0
  9. package/.mokogitea/ISSUE_TEMPLATE/mcp_connection_issue.md +67 -0
  10. package/.mokogitea/ISSUE_TEMPLATE/mcp_tool_request.md +49 -0
  11. package/.mokogitea/ISSUE_TEMPLATE/question.md +82 -0
  12. package/.mokogitea/ISSUE_TEMPLATE/rfc.md +126 -0
  13. package/.mokogitea/ISSUE_TEMPLATE/security.md +51 -0
  14. package/.mokogitea/ISSUE_TEMPLATE/version.md +24 -0
  15. package/.mokogitea/branch-protection.yml +251 -0
  16. package/.mokogitea/workflows/auto-assign.yml +76 -0
  17. package/.mokogitea/workflows/auto-bump.yml +66 -0
  18. package/.mokogitea/workflows/auto-dev-issue.yml +207 -0
  19. package/.mokogitea/workflows/auto-release.yml +421 -0
  20. package/.mokogitea/workflows/branch-cleanup.yml +48 -0
  21. package/.mokogitea/workflows/cascade-dev.yml +10 -0
  22. package/.mokogitea/workflows/changelog-validation.yml +101 -0
  23. package/.mokogitea/workflows/ci-generic.yml +191 -0
  24. package/.mokogitea/workflows/cleanup.yml +87 -0
  25. package/.mokogitea/workflows/codeql-analysis.yml +115 -0
  26. package/.mokogitea/workflows/copilot-agent.yml +44 -0
  27. package/.mokogitea/workflows/deploy-manual.yml +126 -0
  28. package/.mokogitea/workflows/enterprise-firewall-setup.yml +758 -0
  29. package/.mokogitea/workflows/gitleaks.yml +92 -0
  30. package/.mokogitea/workflows/issue-branch.yml +73 -0
  31. package/.mokogitea/workflows/mcp-auto-release.yml +278 -0
  32. package/.mokogitea/workflows/mcp-build-test.yml +65 -0
  33. package/.mokogitea/workflows/mcp-sdk-check.yml +109 -0
  34. package/.mokogitea/workflows/mcp-tool-inventory.yml +61 -0
  35. package/.mokogitea/workflows/notify.yml +70 -0
  36. package/.mokogitea/workflows/npm-publish.yml +113 -0
  37. package/.mokogitea/workflows/pr-check.yml +534 -0
  38. package/.mokogitea/workflows/pre-release.yml +252 -0
  39. package/.mokogitea/workflows/rc-revert.yml +66 -0
  40. package/.mokogitea/workflows/repo-health.yml +712 -0
  41. package/.mokogitea/workflows/repository-cleanup.yml +525 -0
  42. package/.mokogitea/workflows/security-audit.yml +82 -0
  43. package/.mokogitea/workflows/standards-compliance.yml +2614 -0
  44. package/.mokogitea/workflows/sync-version-on-merge.yml +133 -0
  45. package/.mokogitea/workflows/update-server.yml +312 -0
  46. package/.mokogitea/workflows/workflow-sync-trigger.yml +73 -0
  47. package/CHANGELOG.md +130 -0
  48. package/CLAUDE.md +49 -0
  49. package/CONTRIBUTING.md +161 -0
  50. package/ISSUES.md +601 -0
  51. package/Makefile +70 -0
  52. package/README.md +80 -0
  53. package/automation/ci-issue-reporter.sh +237 -0
  54. package/config.example.json +18 -0
  55. package/dist/index.d.ts +3 -0
  56. package/dist/index.js +111 -0
  57. package/dist/shell.d.ts +50 -0
  58. package/dist/shell.js +209 -0
  59. package/dist/tools/apps.d.ts +3 -0
  60. package/dist/tools/apps.js +63 -0
  61. package/dist/tools/audio.d.ts +3 -0
  62. package/dist/tools/audio.js +142 -0
  63. package/dist/tools/audio_apps.d.ts +3 -0
  64. package/dist/tools/audio_apps.js +86 -0
  65. package/dist/tools/automation.d.ts +3 -0
  66. package/dist/tools/automation.js +261 -0
  67. package/dist/tools/bluetooth.d.ts +3 -0
  68. package/dist/tools/bluetooth.js +96 -0
  69. package/dist/tools/clipboard.d.ts +3 -0
  70. package/dist/tools/clipboard.js +118 -0
  71. package/dist/tools/config.d.ts +3 -0
  72. package/dist/tools/config.js +85 -0
  73. package/dist/tools/dialog.d.ts +3 -0
  74. package/dist/tools/dialog.js +72 -0
  75. package/dist/tools/display.d.ts +3 -0
  76. package/dist/tools/display.js +256 -0
  77. package/dist/tools/drives.d.ts +3 -0
  78. package/dist/tools/drives.js +98 -0
  79. package/dist/tools/environment.d.ts +3 -0
  80. package/dist/tools/environment.js +129 -0
  81. package/dist/tools/execute.d.ts +3 -0
  82. package/dist/tools/execute.js +28 -0
  83. package/dist/tools/filesystem.d.ts +3 -0
  84. package/dist/tools/filesystem.js +230 -0
  85. package/dist/tools/firewall.d.ts +3 -0
  86. package/dist/tools/firewall.js +108 -0
  87. package/dist/tools/hosts.d.ts +3 -0
  88. package/dist/tools/hosts.js +119 -0
  89. package/dist/tools/maintenance.d.ts +3 -0
  90. package/dist/tools/maintenance.js +236 -0
  91. package/dist/tools/netstat.d.ts +3 -0
  92. package/dist/tools/netstat.js +56 -0
  93. package/dist/tools/network.d.ts +3 -0
  94. package/dist/tools/network.js +70 -0
  95. package/dist/tools/notification.d.ts +3 -0
  96. package/dist/tools/notification.js +41 -0
  97. package/dist/tools/power.d.ts +3 -0
  98. package/dist/tools/power.js +104 -0
  99. package/dist/tools/printer.d.ts +3 -0
  100. package/dist/tools/printer.js +97 -0
  101. package/dist/tools/process.d.ts +3 -0
  102. package/dist/tools/process.js +54 -0
  103. package/dist/tools/process_kill.d.ts +3 -0
  104. package/dist/tools/process_kill.js +48 -0
  105. package/dist/tools/recycle_bin.d.ts +3 -0
  106. package/dist/tools/recycle_bin.js +108 -0
  107. package/dist/tools/registry.d.ts +3 -0
  108. package/dist/tools/registry.js +136 -0
  109. package/dist/tools/scheduler.d.ts +3 -0
  110. package/dist/tools/scheduler.js +116 -0
  111. package/dist/tools/service.d.ts +3 -0
  112. package/dist/tools/service.js +79 -0
  113. package/dist/tools/startup.d.ts +3 -0
  114. package/dist/tools/startup.js +159 -0
  115. package/dist/tools/storage.d.ts +3 -0
  116. package/dist/tools/storage.js +129 -0
  117. package/dist/tools/system.d.ts +3 -0
  118. package/dist/tools/system.js +84 -0
  119. package/dist/tools/system_mgmt.d.ts +3 -0
  120. package/dist/tools/system_mgmt.js +174 -0
  121. package/dist/tools/terminal.d.ts +3 -0
  122. package/dist/tools/terminal.js +80 -0
  123. package/dist/tools/theme.d.ts +3 -0
  124. package/dist/tools/theme.js +165 -0
  125. package/dist/tools/usb.d.ts +3 -0
  126. package/dist/tools/usb.js +52 -0
  127. package/dist/tools/virtual_desktop.d.ts +3 -0
  128. package/dist/tools/virtual_desktop.js +112 -0
  129. package/dist/tools/wifi.d.ts +3 -0
  130. package/dist/tools/wifi.js +136 -0
  131. package/dist/tools/window.d.ts +3 -0
  132. package/dist/tools/window.js +189 -0
  133. package/dist/tools/winget.d.ts +3 -0
  134. package/dist/tools/winget.js +79 -0
  135. package/dist/tools/wsl.d.ts +3 -0
  136. package/dist/tools/wsl.js +99 -0
  137. package/docs/API.md +63 -0
  138. package/docs/ARCHITECTURE.md +73 -0
  139. package/docs/INSTALLATION.md +102 -0
  140. package/docs/index.md +12 -0
  141. package/package.json +35 -0
  142. package/scripts/setup.mjs +123 -0
  143. package/src/index.ts +125 -0
  144. package/src/shell.ts +253 -0
  145. package/src/tools/apps.ts +76 -0
  146. package/src/tools/audio.ts +161 -0
  147. package/src/tools/audio_apps.ts +98 -0
  148. package/src/tools/automation.ts +297 -0
  149. package/src/tools/bluetooth.ts +114 -0
  150. package/src/tools/clipboard.ts +138 -0
  151. package/src/tools/config.ts +105 -0
  152. package/src/tools/dialog.ts +87 -0
  153. package/src/tools/display.ts +285 -0
  154. package/src/tools/drives.ts +124 -0
  155. package/src/tools/environment.ts +146 -0
  156. package/src/tools/execute.ts +35 -0
  157. package/src/tools/filesystem.ts +273 -0
  158. package/src/tools/firewall.ts +125 -0
  159. package/src/tools/hosts.ts +135 -0
  160. package/src/tools/maintenance.ts +299 -0
  161. package/src/tools/netstat.ts +72 -0
  162. package/src/tools/network.ts +84 -0
  163. package/src/tools/notification.ts +50 -0
  164. package/src/tools/power.ts +123 -0
  165. package/src/tools/printer.ts +114 -0
  166. package/src/tools/process.ts +80 -0
  167. package/src/tools/process_kill.ts +57 -0
  168. package/src/tools/recycle_bin.ts +126 -0
  169. package/src/tools/registry.ts +165 -0
  170. package/src/tools/scheduler.ts +140 -0
  171. package/src/tools/service.ts +102 -0
  172. package/src/tools/startup.ts +180 -0
  173. package/src/tools/storage.ts +141 -0
  174. package/src/tools/system.ts +99 -0
  175. package/src/tools/system_mgmt.ts +190 -0
  176. package/src/tools/terminal.ts +117 -0
  177. package/src/tools/theme.ts +205 -0
  178. package/src/tools/usb.ts +65 -0
  179. package/src/tools/virtual_desktop.ts +122 -0
  180. package/src/tools/wifi.ts +157 -0
  181. package/src/tools/window.ts +211 -0
  182. package/src/tools/winget.ts +100 -0
  183. package/src/tools/wsl.ts +112 -0
  184. package/tsconfig.json +19 -0
package/.gitattributes ADDED
@@ -0,0 +1,94 @@
1
+ ###############################################################################
2
+ # Core normalization
3
+ ###############################################################################
4
+ * text=auto eol=lf
5
+
6
+ # Ensure consistent line endings for scripts
7
+ *.sh text eol=lf
8
+ *.bash text eol=lf
9
+ *.ps1 text eol=lf
10
+ *.cmd text eol=crlf
11
+ *.bat text eol=crlf
12
+
13
+ ###############################################################################
14
+ # Binary handling
15
+ ###############################################################################
16
+ *.png binary
17
+ *.jpg binary
18
+ *.jpeg binary
19
+ *.gif binary
20
+ *.svg binary
21
+ *.ico binary
22
+ *.pdf binary
23
+ *.zip binary
24
+ *.tar binary
25
+ *.tar.gz binary
26
+ *.7z binary
27
+ *.docx binary
28
+ *.xlsx binary
29
+ *.pptx binary
30
+ *.mp3 binary
31
+ *.mp4 binary
32
+ *.woff binary
33
+ *.woff2 binary
34
+ *.ttf binary
35
+ *.otf binary
36
+
37
+ ###############################################################################
38
+ # Export control for GitHub Releases
39
+ # These paths will NOT appear in generated release archives
40
+ ###############################################################################
41
+ # CI and automation
42
+ .github/ export-ignore
43
+ .github/workflows/ export-ignore
44
+ .gitea/ export-ignore
45
+ .gitlab/ export-ignore
46
+
47
+ # Development and tooling
48
+ tests/ export-ignore
49
+ testing/ export-ignore
50
+ tmp/ export-ignore
51
+ docs-internal/ export-ignore
52
+ tools/ export-ignore
53
+
54
+ # Dependency folders that should not ship in release bundles
55
+ node_modules/ export-ignore
56
+ vendor-dev/ export-ignore
57
+
58
+ # Local environment and editor configs
59
+ *.local export-ignore
60
+ *.env export-ignore
61
+ *.env.example export-ignore
62
+ *.code-workspace export-ignore
63
+
64
+ # Project specific non release scaffolding
65
+ dev-assets/ export-ignore
66
+ analysis/ export-ignore
67
+ research/ export-ignore
68
+
69
+ ###############################################################################
70
+ # Linguistic settings for code statistics
71
+ ###############################################################################
72
+ *.css linguist-language=CSS
73
+ *.scss linguist-language=SCSS
74
+ *.js linguist-language=JavaScript
75
+ *.ts linguist-language=TypeScript
76
+ *.php linguist-language=PHP
77
+ *.xml linguist-language=XML
78
+ *.json linguist-language=JSON
79
+ *.ini linguist-language=INI
80
+ *.sql linguist-language=SQL
81
+ *.md linguist-language=Markdown
82
+
83
+ ###############################################################################
84
+ # Prevent diff noise for vendor or minified content
85
+ ###############################################################################
86
+ vendor/* -diff
87
+ *.min.js -diff
88
+ *.min.css -diff
89
+
90
+ ###############################################################################
91
+ # Lockdown for generated files
92
+ ###############################################################################
93
+ *.min.js linguist-generated=true
94
+ *.min.css linguist-generated=true
package/.gitmessage ADDED
@@ -0,0 +1,9 @@
1
+ # <type>(<scope>): <subject>
2
+ # types: build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test
3
+ # subject: imperative, lower-case, no trailing period
4
+
5
+ # Body: what and why
6
+
7
+ # BREAKING CHANGE: <description>
8
+ # Closes: #123
9
+ # Signed-off-by: <Your Name> <you@example.com>
@@ -0,0 +1,110 @@
1
+ ---
2
+ name: Architecture Decision Record (ADR)
3
+ about: Propose or document an architectural decision
4
+ title: '[ADR] '
5
+ labels: 'architecture, decision'
6
+ assignees: ''
7
+
8
+ ---
9
+
10
+
11
+ ## ADR Number
12
+ ADR-XXXX
13
+
14
+ ## Status
15
+ - [ ] Proposed
16
+ - [ ] Accepted
17
+ - [ ] Deprecated
18
+ - [ ] Superseded by ADR-XXXX
19
+
20
+ ## Context
21
+ Describe the issue or problem that motivates this decision.
22
+
23
+ ## Decision
24
+ State the architecture decision and provide rationale.
25
+
26
+ ## Consequences
27
+ ### Positive
28
+ - List positive consequences
29
+
30
+ ### Negative
31
+ - List negative consequences or trade-offs
32
+
33
+ ### Neutral
34
+ - List neutral aspects
35
+
36
+ ## Alternatives Considered
37
+ ### Alternative 1
38
+ - Description
39
+ - Pros
40
+ - Cons
41
+ - Why not chosen
42
+
43
+ ### Alternative 2
44
+ - Description
45
+ - Pros
46
+ - Cons
47
+ - Why not chosen
48
+
49
+ ## Implementation Plan
50
+ 1. Step 1
51
+ 2. Step 2
52
+ 3. Step 3
53
+
54
+ ## Stakeholders
55
+ - **Decision Makers**: @user1, @user2
56
+ - **Consulted**: @user3, @user4
57
+ - **Informed**: team-name
58
+
59
+ ## Technical Details
60
+ ### Architecture Diagram
61
+ ```
62
+ [Add diagram or link]
63
+ ```
64
+
65
+ ### Dependencies
66
+ - Dependency 1
67
+ - Dependency 2
68
+
69
+ ### Impact Analysis
70
+ - **Performance**: [Impact description]
71
+ - **Security**: [Impact description]
72
+ - **Scalability**: [Impact description]
73
+ - **Maintainability**: [Impact description]
74
+
75
+ ## Testing Strategy
76
+ - [ ] Unit tests
77
+ - [ ] Integration tests
78
+ - [ ] Performance tests
79
+ - [ ] Security tests
80
+
81
+ ## Documentation
82
+ - [ ] Architecture documentation updated
83
+ - [ ] API documentation updated
84
+ - [ ] Developer guide updated
85
+ - [ ] Runbook created
86
+
87
+ ## Migration Path
88
+ Describe how to migrate from current state to new architecture.
89
+
90
+ ## Rollback Plan
91
+ Describe how to rollback if issues occur.
92
+
93
+ ## Timeline
94
+ - **Proposal Date**:
95
+ - **Decision Date**:
96
+ - **Implementation Start**:
97
+ - **Expected Completion**:
98
+
99
+ ## References
100
+ - Related ADRs:
101
+ - External resources:
102
+ - RFCs:
103
+
104
+ ## Review Checklist
105
+ - [ ] Aligns with enterprise architecture principles
106
+ - [ ] Security implications reviewed
107
+ - [ ] Performance implications reviewed
108
+ - [ ] Cost implications reviewed
109
+ - [ ] Compliance requirements met
110
+ - [ ] Team consensus achieved
@@ -0,0 +1,48 @@
1
+ ---
2
+ name: Bug Report
3
+ about: Report a bug or issue with the project
4
+ title: '[BUG] '
5
+ labels: 'bug'
6
+ assignees: ''
7
+
8
+ ---
9
+
10
+
11
+ ## Bug Description
12
+ A clear and concise description of what the bug is.
13
+
14
+ ## Steps to Reproduce
15
+ 1. Go to '...'
16
+ 2. Click on '...'
17
+ 3. Scroll down to '...'
18
+ 4. See error
19
+
20
+ ## Expected Behavior
21
+ A clear and concise description of what you expected to happen.
22
+
23
+ ## Actual Behavior
24
+ A clear and concise description of what actually happened.
25
+
26
+ ## Screenshots
27
+ If applicable, add screenshots to help explain your problem.
28
+
29
+ ## Environment
30
+ - **Project**: [e.g., MokoDoliTools, moko-cassiopeia]
31
+ - **Version**: [e.g., 1.2.3]
32
+ - **Platform**: [e.g., Dolibarr 18.0, Joomla 5.0]
33
+ - **PHP Version**: [e.g., 8.1]
34
+ - **Database**: [e.g., MySQL 8.0, PostgreSQL 14]
35
+ - **Browser** (if applicable): [e.g., Chrome 120, Firefox 121]
36
+ - **OS**: [e.g., Ubuntu 22.04, Windows 11]
37
+
38
+ ## Additional Context
39
+ Add any other context about the problem here.
40
+
41
+ ## Possible Solution
42
+ If you have suggestions on how to fix the issue, please describe them here.
43
+
44
+ ## Checklist
45
+ - [ ] I have searched for similar issues before creating this one
46
+ - [ ] I have provided all the requested information
47
+ - [ ] I have tested this on the latest stable version
48
+ - [ ] I have checked the documentation and couldn't find a solution
@@ -0,0 +1,18 @@
1
+ ---
2
+ blank_issues_enabled: true
3
+ contact_links:
4
+ - name: 💼 Enterprise Support
5
+ url: https://mokoconsulting.tech/enterprise
6
+ about: Enterprise-level support and consultation services
7
+ - name: 💬 Ask a Question
8
+ url: https://mokoconsulting.tech/
9
+ about: Get help or ask questions through our website
10
+ - name: 📚 MokoStandards Documentation
11
+ url: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
12
+ about: View our coding standards and best practices
13
+ - name: 🔒 Report a Security Vulnerability
14
+ url: https://git.mokoconsulting.tech/mokoconsulting-tech/.github-private/security/advisories/new
15
+ about: Report security vulnerabilities privately (for critical issues)
16
+ - name: 💡 Community Discussions
17
+ url: https://github.com/orgs/mokoconsulting-tech/discussions
18
+ about: Join community discussions and Q&A
@@ -0,0 +1,52 @@
1
+ ---
2
+ name: Documentation Issue
3
+ about: Report an issue with documentation
4
+ title: '[DOCS] '
5
+ labels: 'documentation'
6
+ assignees: ''
7
+
8
+ ---
9
+
10
+
11
+ ## Documentation Issue
12
+
13
+ **Location**:
14
+ <!-- Specify the file, page, or section with the issue -->
15
+
16
+ ## Issue Type
17
+ <!-- Mark the relevant option with an "x" -->
18
+ - [ ] Typo or grammar error
19
+ - [ ] Outdated information
20
+ - [ ] Missing documentation
21
+ - [ ] Unclear explanation
22
+ - [ ] Broken links
23
+ - [ ] Missing examples
24
+ - [ ] Other (specify below)
25
+
26
+ ## Description
27
+ <!-- Clearly describe the documentation issue -->
28
+
29
+ ## Current Content
30
+ <!-- Quote or describe the current documentation (if applicable) -->
31
+ ```
32
+ Current text here
33
+ ```
34
+
35
+ ## Suggested Improvement
36
+ <!-- Provide your suggestion for how to improve the documentation -->
37
+ ```
38
+ Suggested text here
39
+ ```
40
+
41
+ ## Additional Context
42
+ <!-- Add any other context, screenshots, or references -->
43
+
44
+ ## Standards Alignment
45
+ - [ ] Follows MokoStandards documentation guidelines
46
+ - [ ] Uses en_US/en_GB localization
47
+ - [ ] Includes proper SPDX headers where applicable
48
+
49
+ ## Checklist
50
+ - [ ] I have searched for similar documentation issues
51
+ - [ ] I have provided a clear description
52
+ - [ ] I have suggested an improvement (if applicable)
@@ -0,0 +1,51 @@
1
+ ---
2
+ name: Feature Request
3
+ about: Suggest a new feature or enhancement
4
+ title: '[FEATURE] '
5
+ labels: 'enhancement'
6
+ assignees: ''
7
+
8
+ ---
9
+
10
+
11
+ ## Feature Description
12
+ A clear and concise description of the feature you'd like to see.
13
+
14
+ ## Problem or Use Case
15
+ Describe the problem this feature would solve or the use case it addresses.
16
+ Ex. I'm always frustrated when [...]
17
+
18
+ ## Proposed Solution
19
+ A clear and concise description of what you want to happen.
20
+
21
+ ## Alternative Solutions
22
+ A clear and concise description of any alternative solutions or features you've considered.
23
+
24
+ ## Benefits
25
+ Describe how this feature would benefit users:
26
+ - Who would use this feature?
27
+ - What problems does it solve?
28
+ - What value does it add?
29
+
30
+ ## Implementation Details (Optional)
31
+ If you have ideas about how this could be implemented, share them here:
32
+ - Technical approach
33
+ - Files/components that might need changes
34
+ - Any concerns or challenges you foresee
35
+
36
+ ## Additional Context
37
+ Add any other context, mockups, or screenshots about the feature request here.
38
+
39
+ ## Relevant Standards
40
+ Does this relate to any standards in [MokoStandards](https://git.mokoconsulting.tech/MokoConsulting/MokoStandards)?
41
+ - [ ] Accessibility (WCAG 2.1 AA)
42
+ - [ ] Localization (en_US/en_GB)
43
+ - [ ] Security best practices
44
+ - [ ] Code quality standards
45
+ - [ ] Other: [specify]
46
+
47
+ ## Checklist
48
+ - [ ] I have searched for similar feature requests before creating this one
49
+ - [ ] I have clearly described the use case and benefits
50
+ - [ ] I have considered alternative solutions
51
+ - [ ] This feature aligns with the project's goals and scope
@@ -0,0 +1,48 @@
1
+ ---
2
+ name: API Integration Request
3
+ about: Request integration with a new REST API or service
4
+ title: '[API] '
5
+ labels: 'enhancement, api-integration'
6
+ assignees: ''
7
+
8
+ ---
9
+
10
+ ## API Integration Request
11
+
12
+ ### Target API
13
+ - **Service Name**: [e.g., Akeeba Backup, Joomla Web Services]
14
+ - **API Documentation**: [URL to API docs]
15
+ - **API Type**: [REST / GraphQL / SOAP]
16
+ - **Authentication**: [API Key / OAuth / Bearer Token / Basic Auth]
17
+
18
+ ### Proposed Tools
19
+ List the MCP tools this integration would provide:
20
+
21
+ | Tool Name | HTTP Method | Endpoint | Description |
22
+ |---|---|---|---|
23
+ | `service_list` | GET | `/api/items` | List all items |
24
+ | `service_get` | GET | `/api/items/{id}` | Get single item |
25
+ | `service_create` | POST | `/api/items` | Create item |
26
+
27
+ ### Multi-Connection
28
+ - [ ] Single instance only
29
+ - [ ] Multiple instances (production, staging, dev)
30
+ - [ ] Multi-tenant (one connection per client)
31
+
32
+ ### Use Case
33
+ Describe the workflow this integration enables for AI assistants.
34
+
35
+ ### Priority
36
+ - [ ] Critical — blocking current work
37
+ - [ ] High — needed soon
38
+ - [ ] Medium — would improve workflow
39
+ - [ ] Low — nice to have
40
+
41
+ ### Existing Alternatives
42
+ Are there other ways to accomplish this today? If so, why is an MCP integration better?
43
+
44
+ ### Checklist
45
+ - [ ] API documentation is available and accessible
46
+ - [ ] API supports the required authentication method
47
+ - [ ] I have tested the API endpoints manually
48
+ - [ ] The integration follows the Template-MCP architecture pattern
@@ -0,0 +1,67 @@
1
+ ---
2
+ name: MCP Connection Issue
3
+ about: Report a connection, authentication, or API communication issue
4
+ title: '[CONNECTION] '
5
+ labels: 'bug, mcp-connection'
6
+ assignees: ''
7
+
8
+ ---
9
+
10
+ ## Connection Issue
11
+
12
+ ### Issue Type
13
+ - [ ] Authentication failure (401/403)
14
+ - [ ] Connection refused / timeout
15
+ - [ ] TLS / SSL certificate error
16
+ - [ ] Wrong connection used (wrong environment)
17
+ - [ ] Config file not found / parse error
18
+ - [ ] API response error (4xx / 5xx)
19
+
20
+ ### MCP Server
21
+ - **Server Name**: [e.g., mcp_mokowaas]
22
+ - **Server Version**: [e.g., 1.0.0]
23
+ - **Node.js Version**: [e.g., 20.x]
24
+
25
+ ### Connection Details
26
+ - **Connection Name**: [e.g., production, staging, default]
27
+ - **API Base URL**: [e.g., https://api.example.com] *(do not include API keys)*
28
+ - **Insecure Mode**: [Yes / No]
29
+
30
+ ### Error Message
31
+ ```
32
+ Paste the exact error message here
33
+ ```
34
+
35
+ ### Steps to Reproduce
36
+ 1. Configure connection with `npm run setup`
37
+ 2. Call tool `...` with parameters `...`
38
+ 3. See error
39
+
40
+ ### Expected Behavior
41
+ What should have happened.
42
+
43
+ ### Debugging Attempted
44
+ - [ ] Tested API directly with curl
45
+ - [ ] Verified API key is valid
46
+ - [ ] Checked config file exists and is valid JSON
47
+ - [ ] Tested with `list_connections` tool
48
+ - [ ] Ran server manually: `node dist/index.js 2> debug.log`
49
+
50
+ ### Config File
51
+ ```json
52
+ {
53
+ "defaultConnection": "...",
54
+ "connections": {
55
+ "connection_name": {
56
+ "baseUrl": "https://...",
57
+ "apiKey": "REDACTED"
58
+ }
59
+ }
60
+ }
61
+ ```
62
+ *(Redact all API keys and tokens)*
63
+
64
+ ### Environment
65
+ - **OS**: [e.g., macOS 14, Ubuntu 22.04, Windows 11]
66
+ - **Claude Code Version**: [e.g., latest]
67
+ - **Registration**: [.mcp.json / ~/.claude.json]
@@ -0,0 +1,49 @@
1
+ ---
2
+ name: New MCP Tool Request
3
+ about: Request a new tool to be added to this MCP server
4
+ title: '[TOOL] '
5
+ labels: 'enhancement, mcp-tool'
6
+ assignees: ''
7
+
8
+ ---
9
+
10
+ ## Tool Request
11
+
12
+ ### Tool Name
13
+ Proposed tool name (snake_case): `resource_action`
14
+
15
+ ### Description
16
+ What should this tool do? What API endpoint(s) does it map to?
17
+
18
+ ### API Endpoint(s)
19
+ - **Method**: [GET / POST / PUT / PATCH / DELETE]
20
+ - **Endpoint**: `/api/v1/...`
21
+ - **Auth**: [API Key / Token / None]
22
+
23
+ ### Parameters
24
+
25
+ | Parameter | Type | Required | Description |
26
+ |---|---|---|---|
27
+ | `id` | number | Yes | Resource ID |
28
+ | `search` | string | No | Search filter |
29
+
30
+ ### Expected Response
31
+ ```json
32
+ {
33
+ "id": 1,
34
+ "name": "Example"
35
+ }
36
+ ```
37
+
38
+ ### Use Case
39
+ Describe when and why someone would use this tool from Claude or another AI assistant.
40
+
41
+ ### Connection Scope
42
+ - [ ] Works with all connections
43
+ - [ ] Specific to certain API versions
44
+ - [ ] Requires additional permissions
45
+
46
+ ### Checklist
47
+ - [ ] I have checked this tool does not already exist
48
+ - [ ] I have verified the API endpoint exists and is documented
49
+ - [ ] The proposed name follows the `resource_action` convention
@@ -0,0 +1,82 @@
1
+ ---
2
+ name: Question
3
+ about: Ask a question about usage, features, or best practices
4
+ title: '[QUESTION] '
5
+ labels: ['question']
6
+ assignees: ['jmiller']
7
+ ---
8
+
9
+
10
+ ## Question
11
+
12
+ **Your question:**
13
+
14
+
15
+ ## Context
16
+
17
+ **What are you trying to accomplish?**
18
+
19
+
20
+ **What have you already tried?**
21
+
22
+
23
+ **Category**:
24
+ - [ ] Script usage
25
+ - [ ] Configuration
26
+ - [ ] Workflow setup
27
+ - [ ] Documentation interpretation
28
+ - [ ] Best practices
29
+ - [ ] Integration
30
+ - [ ] Other: __________
31
+
32
+ ## Environment (if relevant)
33
+
34
+ **Your setup**:
35
+ - Operating System:
36
+ - Version:
37
+
38
+ ## What You've Researched
39
+
40
+ **Documentation reviewed**:
41
+ - [ ] README.md
42
+ - [ ] Project documentation
43
+ - [ ] Other (specify): __________
44
+
45
+ **Similar issues/questions found**:
46
+ - #
47
+ - #
48
+
49
+ ## Expected Outcome
50
+
51
+ **What result are you hoping for?**
52
+
53
+
54
+ ## Code/Configuration Samples
55
+
56
+ **Relevant code or configuration** (if applicable):
57
+
58
+ ```bash
59
+ # Your code here
60
+ ```
61
+
62
+ ## Additional Context
63
+
64
+ **Any other relevant information:**
65
+
66
+
67
+ **Screenshots** (if helpful):
68
+
69
+
70
+ ## Urgency
71
+
72
+ - [ ] Urgent (blocking work)
73
+ - [ ] Normal (can work on other things meanwhile)
74
+ - [ ] Low priority (just curious)
75
+
76
+ ## Checklist
77
+
78
+ - [ ] I have searched existing issues and discussions
79
+ - [ ] I have reviewed relevant documentation
80
+ - [ ] I have provided sufficient context
81
+ - [ ] I have included code/configuration samples if relevant
82
+ - [ ] This is a genuine question (not a bug report or feature request)