@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.
- package/.gitattributes +94 -0
- package/.gitmessage +9 -0
- package/.mokogitea/ISSUE_TEMPLATE/adr.md +110 -0
- package/.mokogitea/ISSUE_TEMPLATE/bug_report.md +48 -0
- package/.mokogitea/ISSUE_TEMPLATE/config.yml +18 -0
- package/.mokogitea/ISSUE_TEMPLATE/documentation.md +52 -0
- package/.mokogitea/ISSUE_TEMPLATE/feature_request.md +51 -0
- package/.mokogitea/ISSUE_TEMPLATE/mcp_api_integration.md +48 -0
- package/.mokogitea/ISSUE_TEMPLATE/mcp_connection_issue.md +67 -0
- package/.mokogitea/ISSUE_TEMPLATE/mcp_tool_request.md +49 -0
- package/.mokogitea/ISSUE_TEMPLATE/question.md +82 -0
- package/.mokogitea/ISSUE_TEMPLATE/rfc.md +126 -0
- package/.mokogitea/ISSUE_TEMPLATE/security.md +51 -0
- package/.mokogitea/ISSUE_TEMPLATE/version.md +24 -0
- package/.mokogitea/branch-protection.yml +251 -0
- package/.mokogitea/workflows/auto-assign.yml +76 -0
- package/.mokogitea/workflows/auto-bump.yml +66 -0
- package/.mokogitea/workflows/auto-dev-issue.yml +207 -0
- package/.mokogitea/workflows/auto-release.yml +421 -0
- package/.mokogitea/workflows/branch-cleanup.yml +48 -0
- package/.mokogitea/workflows/cascade-dev.yml +10 -0
- package/.mokogitea/workflows/changelog-validation.yml +101 -0
- package/.mokogitea/workflows/ci-generic.yml +191 -0
- package/.mokogitea/workflows/cleanup.yml +87 -0
- package/.mokogitea/workflows/codeql-analysis.yml +115 -0
- package/.mokogitea/workflows/copilot-agent.yml +44 -0
- package/.mokogitea/workflows/deploy-manual.yml +126 -0
- package/.mokogitea/workflows/enterprise-firewall-setup.yml +758 -0
- package/.mokogitea/workflows/gitleaks.yml +92 -0
- package/.mokogitea/workflows/issue-branch.yml +73 -0
- package/.mokogitea/workflows/mcp-auto-release.yml +278 -0
- package/.mokogitea/workflows/mcp-build-test.yml +65 -0
- package/.mokogitea/workflows/mcp-sdk-check.yml +109 -0
- package/.mokogitea/workflows/mcp-tool-inventory.yml +61 -0
- package/.mokogitea/workflows/notify.yml +70 -0
- package/.mokogitea/workflows/npm-publish.yml +113 -0
- package/.mokogitea/workflows/pr-check.yml +534 -0
- package/.mokogitea/workflows/pre-release.yml +252 -0
- package/.mokogitea/workflows/rc-revert.yml +66 -0
- package/.mokogitea/workflows/repo-health.yml +712 -0
- package/.mokogitea/workflows/repository-cleanup.yml +525 -0
- package/.mokogitea/workflows/security-audit.yml +82 -0
- package/.mokogitea/workflows/standards-compliance.yml +2614 -0
- package/.mokogitea/workflows/sync-version-on-merge.yml +133 -0
- package/.mokogitea/workflows/update-server.yml +312 -0
- package/.mokogitea/workflows/workflow-sync-trigger.yml +73 -0
- package/CHANGELOG.md +130 -0
- package/CLAUDE.md +49 -0
- package/CONTRIBUTING.md +161 -0
- package/ISSUES.md +601 -0
- package/Makefile +70 -0
- package/README.md +80 -0
- package/automation/ci-issue-reporter.sh +237 -0
- package/config.example.json +18 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.js +111 -0
- package/dist/shell.d.ts +50 -0
- package/dist/shell.js +209 -0
- package/dist/tools/apps.d.ts +3 -0
- package/dist/tools/apps.js +63 -0
- package/dist/tools/audio.d.ts +3 -0
- package/dist/tools/audio.js +142 -0
- package/dist/tools/audio_apps.d.ts +3 -0
- package/dist/tools/audio_apps.js +86 -0
- package/dist/tools/automation.d.ts +3 -0
- package/dist/tools/automation.js +261 -0
- package/dist/tools/bluetooth.d.ts +3 -0
- package/dist/tools/bluetooth.js +96 -0
- package/dist/tools/clipboard.d.ts +3 -0
- package/dist/tools/clipboard.js +118 -0
- package/dist/tools/config.d.ts +3 -0
- package/dist/tools/config.js +85 -0
- package/dist/tools/dialog.d.ts +3 -0
- package/dist/tools/dialog.js +72 -0
- package/dist/tools/display.d.ts +3 -0
- package/dist/tools/display.js +256 -0
- package/dist/tools/drives.d.ts +3 -0
- package/dist/tools/drives.js +98 -0
- package/dist/tools/environment.d.ts +3 -0
- package/dist/tools/environment.js +129 -0
- package/dist/tools/execute.d.ts +3 -0
- package/dist/tools/execute.js +28 -0
- package/dist/tools/filesystem.d.ts +3 -0
- package/dist/tools/filesystem.js +230 -0
- package/dist/tools/firewall.d.ts +3 -0
- package/dist/tools/firewall.js +108 -0
- package/dist/tools/hosts.d.ts +3 -0
- package/dist/tools/hosts.js +119 -0
- package/dist/tools/maintenance.d.ts +3 -0
- package/dist/tools/maintenance.js +236 -0
- package/dist/tools/netstat.d.ts +3 -0
- package/dist/tools/netstat.js +56 -0
- package/dist/tools/network.d.ts +3 -0
- package/dist/tools/network.js +70 -0
- package/dist/tools/notification.d.ts +3 -0
- package/dist/tools/notification.js +41 -0
- package/dist/tools/power.d.ts +3 -0
- package/dist/tools/power.js +104 -0
- package/dist/tools/printer.d.ts +3 -0
- package/dist/tools/printer.js +97 -0
- package/dist/tools/process.d.ts +3 -0
- package/dist/tools/process.js +54 -0
- package/dist/tools/process_kill.d.ts +3 -0
- package/dist/tools/process_kill.js +48 -0
- package/dist/tools/recycle_bin.d.ts +3 -0
- package/dist/tools/recycle_bin.js +108 -0
- package/dist/tools/registry.d.ts +3 -0
- package/dist/tools/registry.js +136 -0
- package/dist/tools/scheduler.d.ts +3 -0
- package/dist/tools/scheduler.js +116 -0
- package/dist/tools/service.d.ts +3 -0
- package/dist/tools/service.js +79 -0
- package/dist/tools/startup.d.ts +3 -0
- package/dist/tools/startup.js +159 -0
- package/dist/tools/storage.d.ts +3 -0
- package/dist/tools/storage.js +129 -0
- package/dist/tools/system.d.ts +3 -0
- package/dist/tools/system.js +84 -0
- package/dist/tools/system_mgmt.d.ts +3 -0
- package/dist/tools/system_mgmt.js +174 -0
- package/dist/tools/terminal.d.ts +3 -0
- package/dist/tools/terminal.js +80 -0
- package/dist/tools/theme.d.ts +3 -0
- package/dist/tools/theme.js +165 -0
- package/dist/tools/usb.d.ts +3 -0
- package/dist/tools/usb.js +52 -0
- package/dist/tools/virtual_desktop.d.ts +3 -0
- package/dist/tools/virtual_desktop.js +112 -0
- package/dist/tools/wifi.d.ts +3 -0
- package/dist/tools/wifi.js +136 -0
- package/dist/tools/window.d.ts +3 -0
- package/dist/tools/window.js +189 -0
- package/dist/tools/winget.d.ts +3 -0
- package/dist/tools/winget.js +79 -0
- package/dist/tools/wsl.d.ts +3 -0
- package/dist/tools/wsl.js +99 -0
- package/docs/API.md +63 -0
- package/docs/ARCHITECTURE.md +73 -0
- package/docs/INSTALLATION.md +102 -0
- package/docs/index.md +12 -0
- package/package.json +35 -0
- package/scripts/setup.mjs +123 -0
- package/src/index.ts +125 -0
- package/src/shell.ts +253 -0
- package/src/tools/apps.ts +76 -0
- package/src/tools/audio.ts +161 -0
- package/src/tools/audio_apps.ts +98 -0
- package/src/tools/automation.ts +297 -0
- package/src/tools/bluetooth.ts +114 -0
- package/src/tools/clipboard.ts +138 -0
- package/src/tools/config.ts +105 -0
- package/src/tools/dialog.ts +87 -0
- package/src/tools/display.ts +285 -0
- package/src/tools/drives.ts +124 -0
- package/src/tools/environment.ts +146 -0
- package/src/tools/execute.ts +35 -0
- package/src/tools/filesystem.ts +273 -0
- package/src/tools/firewall.ts +125 -0
- package/src/tools/hosts.ts +135 -0
- package/src/tools/maintenance.ts +299 -0
- package/src/tools/netstat.ts +72 -0
- package/src/tools/network.ts +84 -0
- package/src/tools/notification.ts +50 -0
- package/src/tools/power.ts +123 -0
- package/src/tools/printer.ts +114 -0
- package/src/tools/process.ts +80 -0
- package/src/tools/process_kill.ts +57 -0
- package/src/tools/recycle_bin.ts +126 -0
- package/src/tools/registry.ts +165 -0
- package/src/tools/scheduler.ts +140 -0
- package/src/tools/service.ts +102 -0
- package/src/tools/startup.ts +180 -0
- package/src/tools/storage.ts +141 -0
- package/src/tools/system.ts +99 -0
- package/src/tools/system_mgmt.ts +190 -0
- package/src/tools/terminal.ts +117 -0
- package/src/tools/theme.ts +205 -0
- package/src/tools/usb.ts +65 -0
- package/src/tools/virtual_desktop.ts +122 -0
- package/src/tools/wifi.ts +157 -0
- package/src/tools/window.ts +211 -0
- package/src/tools/winget.ts +100 -0
- package/src/tools/wsl.ts +112 -0
- 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)
|