@teevee98/synapse-hub 0.0.0-stage → 3.8.3
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/.agents/agents/api-engineer.md +67 -0
- package/.agents/agents/failure-analyst.md +75 -0
- package/.agents/agents/live-explorer.md +70 -0
- package/.agents/agents/orchestrator.md +104 -0
- package/.agents/agents/perf-engineer.md +74 -0
- package/.agents/agents/pom-crafter.md +112 -0
- package/.agents/agents/quality-gatekeeper.md +87 -0
- package/.agents/agents/test-designer.md +73 -0
- package/.agents/agents/test-runner.md +67 -0
- package/.agents/rules/author-integrity-guard.md +33 -0
- package/.agents/rules/communication-style.md +18 -0
- package/.agents/rules/context-engineering.md +37 -0
- package/.agents/rules/git-push-protocol.md +33 -0
- package/.agents/rules/graphify.md +14 -0
- package/.agents/rules/lessons-learned.md +25 -0
- package/.agents/rules/mandatory-playwright-live.md +25 -0
- package/.agents/rules/mobile_appium_rules.md +43 -0
- package/.agents/rules/performance_testing_rules.md +35 -0
- package/.agents/rules/skill-precedence.md +29 -0
- package/.agents/rules/systematic-debugging.md +36 -0
- package/.agents/skills/actor-qa-swarm/SKILL.md +77 -0
- package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json +12 -0
- package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +88 -0
- package/.agents/skills/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +15 -0
- package/.agents/skills/agentless-qa-repair/SKILL.md +69 -0
- package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json +17 -0
- package/.agents/skills/agentless-qa-repair/examples/three_phase_repair_workflow.md +40 -0
- package/.agents/skills/antigravity-test-sentinel/SKILL.md +63 -0
- package/.agents/skills/antigravity-test-sentinel/examples/dod_gate_policy.json +11 -0
- package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +47 -0
- package/.agents/skills/api-network-mocking-interception/SKILL.md +142 -0
- package/.agents/skills/api-network-mocking-interception/examples/network_route_stub.json +9 -0
- package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md +80 -0
- package/.agents/skills/api-spec-to-e2e-matrix/examples/sample_openapi.json +19 -0
- package/.agents/skills/architecture-decision-records/SKILL.md +64 -0
- package/.agents/skills/architecture-decision-records/examples/0001-record-architecture-decisions.md +12 -0
- package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +75 -0
- package/.agents/skills/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +70 -0
- package/.agents/skills/auth-session-and-cookie-manager/examples/storage_state_sample.json +11 -0
- package/.agents/skills/backend-load-and-stress-patterns/SKILL.md +85 -0
- package/.agents/skills/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +13 -0
- package/.agents/skills/backend-load-and-stress-patterns/references/k6_load_template.js +82 -0
- package/.agents/skills/bats-testing-patterns/SKILL.md +100 -0
- package/.agents/skills/bats-testing-patterns/examples/cli_runner_test.bats +6 -0
- package/.agents/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
- package/.agents/skills/clean-pom-crafter/SKILL.md +110 -0
- package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy +28 -0
- package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy +138 -0
- package/.agents/skills/code-refactoring-refactor-clean/SKILL.md +64 -0
- package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +9 -0
- package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +52 -0
- package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +881 -0
- package/.agents/skills/consumer-driven-contract-testing/SKILL.md +147 -0
- package/.agents/skills/consumer-driven-contract-testing/examples/order_service_pact.json +45 -0
- package/.agents/skills/db-state-verifier-and-seeder/SKILL.md +123 -0
- package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json +12 -0
- package/.agents/skills/e2e-testing-patterns/SKILL.md +103 -0
- package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts +12 -0
- package/.agents/skills/e2e-testing-patterns/resources/implementation-playbook.md +522 -0
- package/.agents/skills/event-stream-qa-orchestrator/SKILL.md +79 -0
- package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +2 -0
- package/.agents/skills/failure-autopsy-and-healing/SKILL.md +66 -0
- package/.agents/skills/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +48 -0
- package/.agents/skills/failure-autopsy-and-healing/examples/sample_junit_failure.xml +8 -0
- package/.agents/skills/failure-autopsy-and-healing/references/healing_matrix.md +64 -0
- package/.agents/skills/failure-autopsy-and-healing/references/qa_investigation_protocol.md +56 -0
- package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh +83 -0
- package/.agents/skills/file-and-report-validator/SKILL.md +90 -0
- package/.agents/skills/file-and-report-validator/examples/sample_export_schema.json +14 -0
- package/.agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md +114 -0
- package/.agents/skills/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +11 -0
- package/.agents/skills/gherkin-to-suite/SKILL.md +103 -0
- package/.agents/skills/gherkin-to-suite/examples/checkout.feature +39 -0
- package/.agents/skills/gherkin-to-suite/examples/suite_report_sample.json +334 -0
- package/.agents/skills/github-actions-templates/SKILL.md +77 -0
- package/.agents/skills/github-actions-templates/examples/matrix_test_pipeline.yml +8 -0
- package/.agents/skills/graphify-impact-analyzer/SKILL.md +76 -0
- package/.agents/skills/graphify-impact-analyzer/examples/dependency_blast_radius.json +8 -0
- package/.agents/skills/katalon-cli-runner/SKILL.md +76 -0
- package/.agents/skills/katalon-cli-runner/examples/headless_kre_exec.sh +3 -0
- package/.agents/skills/katalon-cli-runner/references/groovy-patterns.md +209 -0
- package/.agents/skills/katalon-cli-runner/references/katalon-api.md +155 -0
- package/.agents/skills/katalon-cli-runner/references/runner_commands.md +67 -0
- package/.agents/skills/lam-script-generator/SKILL.md +123 -0
- package/.agents/skills/lam-script-generator/examples/user_story_sample.md +8 -0
- package/.agents/skills/lean-code-ladder/SKILL.md +94 -0
- package/.agents/skills/lean-code-ladder/examples/ladder_walkthrough.md +37 -0
- package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
- package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
- package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
- package/.agents/skills/meta-prompt-crafter/SKILL.md +107 -0
- package/.agents/skills/meta-prompt-crafter/examples/qa_prompt_template.md +35 -0
- package/.agents/skills/mipro-prompt-compiler/SKILL.md +59 -0
- package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json +22 -0
- package/.agents/skills/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +46 -0
- package/.agents/skills/mobile-appium-som/SKILL.md +88 -0
- package/.agents/skills/mobile-appium-som/examples/BaseScreen.java +88 -0
- package/.agents/skills/mobile-appium-som/examples/LoginScreen.java +46 -0
- package/.agents/skills/mobile-appium-som/examples/TC_MobileLogin.java +43 -0
- package/.agents/skills/persistent-planning-files/SKILL.md +108 -0
- package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +56 -0
- package/.agents/skills/playwright-live-interaction/SKILL.md +131 -0
- package/.agents/skills/playwright-live-interaction/examples/live_probe_script.js +5 -0
- package/.agents/skills/playwright-live-interaction/references/advanced_superpowers.md +160 -0
- package/.agents/skills/playwright-live-interaction/references/compact_accessibility_snapshots.md +75 -0
- package/.agents/skills/playwright-live-interaction/references/recipes.md +388 -0
- package/.agents/skills/playwright-live-interaction/references/swarm_orchestration.md +134 -0
- package/.agents/skills/playwright-webapp-testing/SKILL.md +93 -0
- package/.agents/skills/playwright-webapp-testing/examples/server_lifecycle_playwright.py +63 -0
- package/.agents/skills/qa-aci-interface/SKILL.md +67 -0
- package/.agents/skills/qa-aci-interface/examples/surgical_code_window_walkthrough.md +40 -0
- package/.agents/skills/qa-aci-interface/examples/surgical_edit_sample.json +12 -0
- package/.agents/skills/qa-memory-os/SKILL.md +80 -0
- package/.agents/skills/qa-memory-os/examples/archival_memory_sample.json +21 -0
- package/.agents/skills/rbt-manual-testing/SKILL.md +137 -0
- package/.agents/skills/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +25 -0
- package/.agents/skills/rbt-manual-testing/references/field_validation_checklist.md +29 -0
- package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
- package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
- package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
- package/.agents/skills/review-spec/SKILL.md +60 -0
- package/.agents/skills/review-spec/examples/pocock_grilling_decision_rubric.md +40 -0
- package/.agents/skills/review-spec/examples/sample_spec_review.md +33 -0
- package/.agents/skills/security-dast-sentinel/SKILL.md +119 -0
- package/.agents/skills/security-dast-sentinel/examples/dast_scan_config.json +10 -0
- package/.agents/skills/security-dast-sentinel/references/AI-AND-LLM.md +113 -0
- package/.agents/skills/security-dast-sentinel/references/ATTACK-CLASSES.md +89 -0
- package/.agents/skills/security-dast-sentinel/references/dast_recipes.ts +33 -0
- package/.agents/skills/self-healing-locator/SKILL.md +86 -0
- package/.agents/skills/self-healing-locator/examples/aom_diff_sample.json +16 -0
- package/.agents/skills/senior-code-review/SKILL.md +108 -0
- package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
- package/.agents/skills/skillspector-security-guard/SKILL.md +57 -0
- package/.agents/skills/skillspector-security-guard/examples/audit_threat_vectors_report.json +35 -0
- package/.agents/skills/skillspector-security-guard/examples/safe_mcp_config.json +12 -0
- package/.agents/skills/surgical-coding-principles/SKILL.md +89 -0
- package/.agents/skills/surgical-coding-principles/examples/surgical_vs_scope_creep.md +46 -0
- package/.agents/skills/synthetic-test-data-generator/SKILL.md +135 -0
- package/.agents/skills/synthetic-test-data-generator/examples/idempotent_data_recipe.json +9 -0
- package/.agents/skills/systematic-debugging/SKILL.md +100 -0
- package/.agents/skills/systematic-debugging/examples/four_phase_case.md +44 -0
- package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
- package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
- package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
- package/.agents/skills/test-driven-development/SKILL.md +114 -0
- package/.agents/skills/test-driven-development/examples/red_green_refactor_qa.md +78 -0
- package/.agents/skills/token-and-context-optimizer/SKILL.md +70 -0
- package/.agents/skills/token-and-context-optimizer/examples/distilled_log_sample.txt +3 -0
- package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
- package/.agents/skills/tot-exploratory-testing/SKILL.md +59 -0
- package/.agents/skills/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +62 -0
- package/.agents/skills/tot-exploratory-testing/examples/tot_graph_sample.json +35 -0
- package/.agents/skills/verification-before-completion/SKILL.md +100 -0
- package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +46 -0
- package/.agents/skills/visual-regression-sentinel/SKILL.md +82 -0
- package/.agents/skills/visual-regression-sentinel/examples/visual_mask_rules.json +9 -0
- package/.agents/skills/wcag-audit-patterns/SKILL.md +77 -0
- package/.agents/skills/wcag-audit-patterns/examples/wcag_compliance_checklist.json +10 -0
- package/.agents/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
- package/.agents/skills/web-agent-gym-benchmarking/SKILL.md +62 -0
- package/.agents/skills/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +22 -0
- package/.agents/skills/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +38 -0
- package/.agents/skills/web-vitals-and-performance-profiler/SKILL.md +65 -0
- package/.agents/skills/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +6 -0
- package/.agents/skills/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +118 -0
- package/.agents/templates/completion_report.md +57 -0
- package/.agents/workflows/analyze_requirement_document.md +18 -0
- package/.agents/workflows/export_testcases_excel.md +32 -0
- package/.agents/workflows/generate_combinatorial_test_data.md +28 -0
- package/.agents/workflows/generate_cross_module_test_plan.md +37 -0
- package/.agents/workflows/generate_manual_testcases_rbt.md +56 -0
- package/.agents/workflows/generate_requirements_from_website.md +25 -0
- package/.agents/workflows/generate_testcases_from_requirements.md +21 -0
- package/.agents/workflows/graphify.md +10 -0
- package/.agents/workflows/test-impact.md +15 -0
- package/.agents/workflows/verify.md +34 -0
- package/.cursor/rules/agents.mdc +16 -0
- package/.cursor/rules/language.mdc +7 -0
- package/.cursor/rules/synapse-qa.mdc +24 -0
- package/.cursorrules +27 -0
- package/.dockerignore +53 -0
- package/.pre-commit-hooks.yaml +14 -0
- package/.windsurfrules +26 -0
- package/AGENTS.md +86 -0
- package/CLAUDE.md +54 -0
- package/Dockerfile +81 -0
- package/LICENSE +52 -0
- package/NOTICE +264 -0
- package/README.en.md +171 -0
- package/README.md +170 -2
- package/action.yml +51 -0
- package/agentskills.json +16 -0
- package/bin/agent-qa.js +138 -0
- package/docker-compose.yml +74 -0
- package/docs/ARCHITECTURE.en.md +198 -0
- package/docs/ARCHITECTURE.md +199 -0
- package/docs/CI_CD_INTEGRATION.en.md +170 -0
- package/docs/CI_CD_INTEGRATION.md +170 -0
- package/docs/CLI_REFERENCE.en.md +174 -0
- package/docs/CLI_REFERENCE.md +176 -0
- package/docs/CONTRIBUTING.en.md +49 -0
- package/docs/CONTRIBUTING.md +49 -0
- package/docs/PERFORMANCE_AUDIT_REPORT.md +783 -0
- package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
- package/docs/QUALITY_GATES.en.md +118 -0
- package/docs/QUALITY_GATES.md +118 -0
- package/docs/TOKEN_QUOTA_PLAYBOOK.md +41 -0
- package/docs/TOOL_CATALOG.md +129 -0
- package/docs/adopted-ecosystem-tools.md +96 -0
- package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +1062 -0
- package/docs/research/agent_skill_training_analysis.md +1358 -0
- package/docs/schemas/synapse.config.schema.json +86 -0
- package/package.json +94 -4
- package/plugin.json +31 -0
- package/scripts/generate_skill_examples.py +244 -0
- package/scripts/install.ps1 +112 -0
- package/scripts/install_global_plugin.ps1 +94 -0
- package/scripts/install_global_plugin.sh +49 -0
- package/scripts/lint_skills.ps1 +57 -0
- package/scripts/package_dist.py +337 -0
- package/scripts/setup.sh +59 -0
- package/scripts/update_hub.ps1 +19 -0
- package/scripts/update_hub.sh +15 -0
- package/skills_manifest.json +854 -0
- package/synapse.config.json +31 -0
- package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +111 -0
- package/templates/PROJECT_STATE_TEMPLATE.md +20 -0
- package/templates/ai_bridges/CLAUDE.md +54 -0
- package/templates/ai_bridges/copilot-instructions.md +20 -0
- package/templates/ai_bridges/cursor_synapse_qa.mdc +24 -0
- package/templates/ai_bridges/windsurfrules +26 -0
- package/templates/ci/github-actions-synapse.yml +95 -0
- package/templates/ci/gitlab-ci-synapse.yml +16 -0
- package/templates/ui/index.html +1069 -0
- package/templates/welcome.html.tmpl +2074 -0
- package/tools/.infer_baseline.json +30 -0
- package/tools/TOOLS_RUNBOOK.md +1553 -0
- package/tools/TOOL_CATALOG.json +1769 -0
- package/tools/__init__.py +43 -0
- package/tools/_openapi_parser.py +158 -0
- package/tools/agent_canary.py +525 -0
- package/tools/agentless_patcher.py +417 -0
- package/tools/analyze_project.py +262 -0
- package/tools/api_drift_sentinel.py +208 -0
- package/tools/api_fuzzer.py +762 -0
- package/tools/author_integrity.py +190 -0
- package/tools/auto_heal.py +271 -0
- package/tools/auto_heal_reflexion.py +532 -0
- package/tools/autogen_qa_broker.py +844 -0
- package/tools/benchmark_swarm_context.py +394 -0
- package/tools/browser_helpers.js +746 -0
- package/tools/browsergym_eval.py +236 -0
- package/tools/bug_reporter.py +252 -0
- package/tools/bump_version.py +423 -0
- package/tools/cache_resolver.py +1214 -0
- package/tools/check_env.py +426 -0
- package/tools/check_version_sync.py +256 -0
- package/tools/ci_healing_hook.py +126 -0
- package/tools/cli.py +1598 -0
- package/tools/config_decoupler.py +253 -0
- package/tools/contract_validator.py +141 -0
- package/tools/core/__init__.py +70 -0
- package/tools/core/adapters.py +431 -0
- package/tools/core/circuit_breaker.py +263 -0
- package/tools/core/cli_runtime.py +66 -0
- package/tools/core/file_lock.py +159 -0
- package/tools/core/i18n.py +394 -0
- package/tools/core/memory_bus.py +905 -0
- package/tools/core/process_supervisor.py +332 -0
- package/tools/core/telemetry.py +329 -0
- package/tools/count_tokens.py +1267 -0
- package/tools/create_mock_docx.py +104 -0
- package/tools/dashboard_generator.py +2403 -0
- package/tools/db_sandbox.py +675 -0
- package/tools/debt_harvester.py +237 -0
- package/tools/distill_log.py +161 -0
- package/tools/dspy_qa_signatures.py +356 -0
- package/tools/e2e_flow_prober.py +132 -0
- package/tools/export_postman_collection.py +945 -0
- package/tools/flaky_detector.py +389 -0
- package/tools/fsm_enforcer.py +450 -0
- package/tools/fsm_middleware.py +401 -0
- package/tools/fuzz_payloads.py +197 -0
- package/tools/generate_allure_report.py +88 -0
- package/tools/generate_api_matrix.py +193 -0
- package/tools/generate_jmx_plan.py +1322 -0
- package/tools/generate_sbom.py +252 -0
- package/tools/generate_tc_from_story.py +203 -0
- package/tools/generate_test_reports.py +133 -0
- package/tools/generate_tool_catalog.py +482 -0
- package/tools/gherkin_suite.py +758 -0
- package/tools/git_pre_commit_guard.py +298 -0
- package/tools/goldfish_review.py +366 -0
- package/tools/heal/__init__.py +28 -0
- package/tools/heal_pr_automator.py +220 -0
- package/tools/heuristic_locator_matcher.py +351 -0
- package/tools/hub_publisher.py +623 -0
- package/tools/humanize_linter.py +438 -0
- package/tools/infer_linter.py +977 -0
- package/tools/init_config.py +306 -0
- package/tools/interview_story.py +116 -0
- package/tools/jira_sync.py +566 -0
- package/tools/jtl_analyzer.py +474 -0
- package/tools/lint/__init__.py +30 -0
- package/tools/lint_ai_docs.py +374 -0
- package/tools/lookup_tc.py +165 -0
- package/tools/lookup_xpath.py +167 -0
- package/tools/matrix_sharder.py +148 -0
- package/tools/mcp/__init__.py +18 -0
- package/tools/mcp_docx_server.ps1 +13 -0
- package/tools/mcp_docx_server.py +851 -0
- package/tools/mcp_excel_server.ps1 +13 -0
- package/tools/mcp_excel_server.py +441 -0
- package/tools/mcp_server.py +725 -0
- package/tools/md_to_xlsx.py +327 -0
- package/tools/micro_mutator.py +887 -0
- package/tools/mipro_assertion_tuner.py +210 -0
- package/tools/network_mock_shield.py +311 -0
- package/tools/newman_analyzer.py +384 -0
- package/tools/omni_emitter.py +579 -0
- package/tools/omni_parser.py +450 -0
- package/tools/omni_transpiler.py +168 -0
- package/tools/openxml_guard.py +438 -0
- package/tools/output_formatter.py +182 -0
- package/tools/package_release.py +325 -0
- package/tools/perf/__init__.py +24 -0
- package/tools/pinpoint_failure.py +190 -0
- package/tools/project_state.py +171 -0
- package/tools/qa_event_stream.py +358 -0
- package/tools/repo_map.py +346 -0
- package/tools/report/__init__.py +32 -0
- package/tools/reversible_sandbox.py +344 -0
- package/tools/safety_firewall.py +437 -0
- package/tools/security_coverage_ledger.py +538 -0
- package/tools/security_scanner.py +229 -0
- package/tools/senior_code_review.py +393 -0
- package/tools/setup_project.py +770 -0
- package/tools/skill_collision_guard.py +304 -0
- package/tools/skill_profiles.py +217 -0
- package/tools/skill_vault.py +481 -0
- package/tools/skillspector.py +1278 -0
- package/tools/smart_visual_masker.py +132 -0
- package/tools/spec_drift_sentinel.py +438 -0
- package/tools/swe_qa_aci.py +369 -0
- package/tools/synapse_observer.py +485 -0
- package/tools/synapse_qa_bench.py +190 -0
- package/tools/sync_agent_rules.py +274 -0
- package/tools/telemetry_correlator.py +397 -0
- package/tools/template_excel_exporter.py +514 -0
- package/tools/templates/jmeter-distributed/README.md +54 -0
- package/tools/templates/jmeter-distributed/docker-compose.yml +83 -0
- package/tools/test_impact.py +419 -0
- package/tools/test_memory_os.py +462 -0
- package/tools/textgrad_mutation_optimizer.py +237 -0
- package/tools/tms_sync_bridge.py +834 -0
- package/tools/tot_exploratory_tester.py +239 -0
- package/tools/trace_data_flow.py +240 -0
- package/tools/traffic_session_converter.py +256 -0
- package/tools/trend_analytics.py +314 -0
- package/tools/ui_server.py +401 -0
- package/tools/universal_ir.py +488 -0
- package/tools/update_sentinel.py +383 -0
- package/tools/validate_groovy_scripts.py +173 -0
- package/tools/verify_all.py +1271 -0
- package/tools/visual_diff_canvas.py +143 -0
- package/tools/visual_som_helper.py +550 -0
- package/tools/watch_mode.py +308 -0
- package/tools/wcag_audit.py +239 -0
- package/tools/welcome_page.py +290 -0
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# Enterprise MCP Excel Server Wrapper
|
|
2
|
+
$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
|
|
3
|
+
$pythonCmd = Get-Command python -ErrorAction SilentlyContinue
|
|
4
|
+
if (-not $pythonCmd) { $pythonCmd = Get-Command py -ErrorAction SilentlyContinue }
|
|
5
|
+
if (-not $pythonCmd) { $pythonCmd = Get-Command python3 -ErrorAction SilentlyContinue }
|
|
6
|
+
|
|
7
|
+
if ($pythonCmd) {
|
|
8
|
+
& $pythonCmd.Source "$scriptDir\mcp_excel_server.py" $args
|
|
9
|
+
exit $LASTEXITCODE
|
|
10
|
+
} else {
|
|
11
|
+
Write-Error "Python 3 is required to run mcp_excel_server.py."
|
|
12
|
+
exit 1
|
|
13
|
+
}
|
|
@@ -0,0 +1,441 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
Enterprise Cross-Platform MCP Excel Server (Zero-Dependency)
|
|
4
|
+
-----------------------------------------------------------
|
|
5
|
+
Implements Model Context Protocol (MCP) JSON-RPC 2.0 stdio server
|
|
6
|
+
for reading and inspecting Microsoft Excel (.xlsx) workbooks.
|
|
7
|
+
Works 100% offline with Python Standard Library (zipfile + xml.etree.ElementTree),
|
|
8
|
+
with transparent fallback to openpyxl if installed.
|
|
9
|
+
"""
|
|
10
|
+
|
|
11
|
+
import os
|
|
12
|
+
import sys
|
|
13
|
+
import json
|
|
14
|
+
import zipfile
|
|
15
|
+
from pathlib import Path
|
|
16
|
+
from typing import Dict, Any, List, Optional, Union
|
|
17
|
+
|
|
18
|
+
try:
|
|
19
|
+
from openxml_guard import (
|
|
20
|
+
validate_openxml_path,
|
|
21
|
+
validate_output_path,
|
|
22
|
+
safe_open_zip,
|
|
23
|
+
safe_parse_xml,
|
|
24
|
+
jsonrpc_error_response,
|
|
25
|
+
PARSE_ERROR,
|
|
26
|
+
INVALID_REQUEST,
|
|
27
|
+
METHOD_NOT_FOUND,
|
|
28
|
+
INVALID_PARAMS,
|
|
29
|
+
INTERNAL_ERROR,
|
|
30
|
+
MAX_ZIP_ENTRIES
|
|
31
|
+
)
|
|
32
|
+
except ImportError:
|
|
33
|
+
from tools.openxml_guard import (
|
|
34
|
+
validate_openxml_path,
|
|
35
|
+
validate_output_path,
|
|
36
|
+
safe_open_zip,
|
|
37
|
+
safe_parse_xml,
|
|
38
|
+
jsonrpc_error_response,
|
|
39
|
+
PARSE_ERROR,
|
|
40
|
+
INVALID_REQUEST,
|
|
41
|
+
METHOD_NOT_FOUND,
|
|
42
|
+
INVALID_PARAMS,
|
|
43
|
+
INTERNAL_ERROR,
|
|
44
|
+
MAX_ZIP_ENTRIES
|
|
45
|
+
)
|
|
46
|
+
|
|
47
|
+
# Enforce UTF-8 stdio
|
|
48
|
+
if hasattr(sys.stdout, 'reconfigure'):
|
|
49
|
+
try:
|
|
50
|
+
sys.stdout.reconfigure(encoding='utf-8')
|
|
51
|
+
sys.stderr.reconfigure(encoding='utf-8')
|
|
52
|
+
except Exception:
|
|
53
|
+
pass
|
|
54
|
+
|
|
55
|
+
SERVER_VERSION = "3.8.3"
|
|
56
|
+
MAX_XLSX_SIZE = 50 * 1024 * 1024 # 50 MB
|
|
57
|
+
MAX_UNCOMPRESSED_SIZE = 200 * 1024 * 1024 # 200 MB
|
|
58
|
+
MAX_RATIO = 100 # 100:1 compression ratio limit
|
|
59
|
+
|
|
60
|
+
NS_MAIN = "{http://schemas.openxmlformats.org/spreadsheetml/2006/main}"
|
|
61
|
+
NS_REL = "{http://schemas.openxmlformats.org/officeDocument/2006/relationships}"
|
|
62
|
+
|
|
63
|
+
|
|
64
|
+
def validate_excel_path(path: str, workspace_root: Optional[Union[str, Path]] = None) -> str:
|
|
65
|
+
"""Validates that path is safe, does not resolve to sensitive system directories, and is a valid .xlsx file."""
|
|
66
|
+
target = validate_openxml_path(
|
|
67
|
+
path,
|
|
68
|
+
workspace_root=workspace_root,
|
|
69
|
+
allowed_extensions=('.xlsx',),
|
|
70
|
+
max_file_size=MAX_XLSX_SIZE
|
|
71
|
+
)
|
|
72
|
+
return str(target)
|
|
73
|
+
|
|
74
|
+
|
|
75
|
+
def get_shared_strings(z: zipfile.ZipFile) -> List[str]:
|
|
76
|
+
"""Reads shared strings table from xl/sharedStrings.xml."""
|
|
77
|
+
if "xl/sharedStrings.xml" not in z.namelist():
|
|
78
|
+
return []
|
|
79
|
+
try:
|
|
80
|
+
with z.open("xl/sharedStrings.xml") as f:
|
|
81
|
+
root = safe_parse_xml(f)
|
|
82
|
+
strings = []
|
|
83
|
+
for si in root.iter(f"{NS_MAIN}si"):
|
|
84
|
+
# Concatenate all text inside <t> elements
|
|
85
|
+
text = "".join(t.text or "" for t in si.iter(f"{NS_MAIN}t"))
|
|
86
|
+
strings.append(text)
|
|
87
|
+
return strings
|
|
88
|
+
except (KeyError, ValueError):
|
|
89
|
+
return []
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
def get_sheet_names(z: zipfile.ZipFile) -> List[str]:
|
|
93
|
+
"""Retrieves sheet names from xl/workbook.xml."""
|
|
94
|
+
if "xl/workbook.xml" not in z.namelist():
|
|
95
|
+
return ["Sheet1"]
|
|
96
|
+
try:
|
|
97
|
+
with z.open("xl/workbook.xml") as f:
|
|
98
|
+
root = safe_parse_xml(f)
|
|
99
|
+
sheets = []
|
|
100
|
+
for sheet in root.iter(f"{NS_MAIN}sheet"):
|
|
101
|
+
name = sheet.attrib.get("name")
|
|
102
|
+
if name:
|
|
103
|
+
sheets.append(name)
|
|
104
|
+
return sheets or ["Sheet1"]
|
|
105
|
+
except (KeyError, ValueError):
|
|
106
|
+
return ["Sheet1"]
|
|
107
|
+
|
|
108
|
+
|
|
109
|
+
def read_sheet_rows(xlsx_path: str, sheet_name: Optional[str] = None, max_rows: int = 100) -> List[List[str]]:
|
|
110
|
+
"""Reads rows from an Excel .xlsx file using Python standard library."""
|
|
111
|
+
valid_path = validate_excel_path(xlsx_path)
|
|
112
|
+
|
|
113
|
+
with safe_open_zip(valid_path, max_entries=MAX_ZIP_ENTRIES, max_uncompressed_size=MAX_UNCOMPRESSED_SIZE, max_ratio=MAX_RATIO) as z:
|
|
114
|
+
shared_strings = get_shared_strings(z)
|
|
115
|
+
sheet_names = get_sheet_names(z)
|
|
116
|
+
|
|
117
|
+
sheet_idx = 1
|
|
118
|
+
if sheet_name and sheet_name in sheet_names:
|
|
119
|
+
sheet_idx = sheet_names.index(sheet_name) + 1
|
|
120
|
+
|
|
121
|
+
sheet_entry = f"xl/worksheets/sheet{sheet_idx}.xml"
|
|
122
|
+
if sheet_entry not in z.namelist():
|
|
123
|
+
candidates = [n for n in z.namelist() if n.startswith("xl/worksheets/sheet") and n.endswith(".xml")]
|
|
124
|
+
if candidates:
|
|
125
|
+
sheet_entry = candidates[0]
|
|
126
|
+
else:
|
|
127
|
+
return []
|
|
128
|
+
|
|
129
|
+
try:
|
|
130
|
+
with z.open(sheet_entry) as f:
|
|
131
|
+
root = safe_parse_xml(f)
|
|
132
|
+
except ValueError as err:
|
|
133
|
+
raise ValueError(f"Corrupt worksheet '{sheet_entry}': {err}")
|
|
134
|
+
|
|
135
|
+
rows_data = []
|
|
136
|
+
for row in root.iter(f"{NS_MAIN}row"):
|
|
137
|
+
cells = []
|
|
138
|
+
for c in row.iter(f"{NS_MAIN}c"):
|
|
139
|
+
cell_type = c.attrib.get("t")
|
|
140
|
+
val_elem = c.find(f"{NS_MAIN}v")
|
|
141
|
+
raw_val = (val_elem.text or "") if val_elem is not None else ""
|
|
142
|
+
|
|
143
|
+
if cell_type == "s" and raw_val.isdigit():
|
|
144
|
+
idx = int(raw_val)
|
|
145
|
+
val = shared_strings[idx] if idx < len(shared_strings) else raw_val
|
|
146
|
+
elif cell_type == "b":
|
|
147
|
+
val = "TRUE" if raw_val == "1" else "FALSE"
|
|
148
|
+
else:
|
|
149
|
+
val = raw_val
|
|
150
|
+
|
|
151
|
+
cells.append(str(val))
|
|
152
|
+
if any(cells):
|
|
153
|
+
rows_data.append(cells)
|
|
154
|
+
if len(rows_data) >= max_rows:
|
|
155
|
+
break
|
|
156
|
+
|
|
157
|
+
return rows_data
|
|
158
|
+
|
|
159
|
+
|
|
160
|
+
def handle_tool_call(name: str, arguments: Dict[str, Any]) -> str:
|
|
161
|
+
"""Executes Excel MCP tool functions."""
|
|
162
|
+
if name not in MCP_EXCEL_TOOL_NAMES:
|
|
163
|
+
raise ValueError(f"Unknown MCP Excel tool: {name}")
|
|
164
|
+
|
|
165
|
+
if name == "list_excel_sheets":
|
|
166
|
+
file_path = arguments.get("file_path")
|
|
167
|
+
if not file_path or not isinstance(file_path, str):
|
|
168
|
+
raise ValueError("Tool argument 'file_path' is required and must be a string.")
|
|
169
|
+
valid_path = validate_excel_path(file_path)
|
|
170
|
+
with safe_open_zip(valid_path, max_entries=MAX_ZIP_ENTRIES, max_uncompressed_size=MAX_UNCOMPRESSED_SIZE, max_ratio=MAX_RATIO) as z:
|
|
171
|
+
sheets = get_sheet_names(z)
|
|
172
|
+
return json.dumps({"file": valid_path, "sheets": sheets}, indent=2)
|
|
173
|
+
|
|
174
|
+
elif name == "read_excel_sheet":
|
|
175
|
+
file_path = arguments.get("file_path")
|
|
176
|
+
if not file_path or not isinstance(file_path, str):
|
|
177
|
+
raise ValueError("Tool argument 'file_path' is required and must be a string.")
|
|
178
|
+
valid_path = validate_excel_path(file_path)
|
|
179
|
+
sheet_name = arguments.get("sheet_name")
|
|
180
|
+
max_rows = int(arguments.get("max_rows", 50))
|
|
181
|
+
rows = read_sheet_rows(valid_path, sheet_name=sheet_name, max_rows=max_rows)
|
|
182
|
+
if not rows:
|
|
183
|
+
return f"Sheet '{sheet_name or 'Sheet1'}' is empty."
|
|
184
|
+
|
|
185
|
+
# Format as Markdown table
|
|
186
|
+
header = rows[0]
|
|
187
|
+
md_lines = [
|
|
188
|
+
"| " + " | ".join(header) + " |",
|
|
189
|
+
"| " + " | ".join(["---"] * len(header)) + " |"
|
|
190
|
+
]
|
|
191
|
+
for row in rows[1:]:
|
|
192
|
+
padded = row + [""] * (len(header) - len(row))
|
|
193
|
+
md_lines.append("| " + " | ".join(padded[:len(header)]) + " |")
|
|
194
|
+
|
|
195
|
+
return "\n".join(md_lines)
|
|
196
|
+
|
|
197
|
+
elif name == "export_testcases_to_excel":
|
|
198
|
+
markdown_content = arguments.get("markdown_content", "")
|
|
199
|
+
output_path = arguments.get("output_path", "")
|
|
200
|
+
if not markdown_content or not output_path:
|
|
201
|
+
raise ValueError("Both 'markdown_content' and 'output_path' are required.")
|
|
202
|
+
|
|
203
|
+
valid_output = validate_output_path(output_path, allowed_extensions=('.xlsx',), create_parent=True)
|
|
204
|
+
|
|
205
|
+
template_path = arguments.get("template_path")
|
|
206
|
+
if template_path:
|
|
207
|
+
template_path = str(validate_openxml_path(template_path, allowed_extensions=('.xlsx',)))
|
|
208
|
+
|
|
209
|
+
sample_sheet = arguments.get("sample_sheet")
|
|
210
|
+
sheet_name = arguments.get("sheet_name")
|
|
211
|
+
module_code = arguments.get("module_code", "MODULE")
|
|
212
|
+
module_name = arguments.get("module_name", "Test Cases")
|
|
213
|
+
author = arguments.get("author", "QA Engineer")
|
|
214
|
+
|
|
215
|
+
try:
|
|
216
|
+
import template_excel_exporter as tee
|
|
217
|
+
except ImportError:
|
|
218
|
+
from tools import template_excel_exporter as tee
|
|
219
|
+
|
|
220
|
+
cfg = tee.find_project_config(os.path.dirname(os.path.abspath(str(valid_output))))
|
|
221
|
+
if cfg and not template_path:
|
|
222
|
+
tc_cfg = cfg.get("testcase_export", {})
|
|
223
|
+
cfg_dir = cfg.get("_config_dir", "")
|
|
224
|
+
if "template_path" in tc_cfg:
|
|
225
|
+
raw_tp = os.path.normpath(os.path.join(cfg_dir, tc_cfg["template_path"]))
|
|
226
|
+
if os.path.exists(raw_tp):
|
|
227
|
+
template_path = str(validate_openxml_path(raw_tp, allowed_extensions=('.xlsx',)))
|
|
228
|
+
if "sample_sheet" in tc_cfg:
|
|
229
|
+
sample_sheet = tc_cfg["sample_sheet"]
|
|
230
|
+
if "author" in cfg.get("project", {}):
|
|
231
|
+
author = cfg["project"]["author"]
|
|
232
|
+
|
|
233
|
+
rows = tee.parse_testcases_from_markdown(markdown_content)
|
|
234
|
+
if template_path and os.path.exists(template_path):
|
|
235
|
+
res_path = tee.clone_and_export_template(
|
|
236
|
+
rows=rows,
|
|
237
|
+
output_path=str(valid_output),
|
|
238
|
+
template_path=template_path,
|
|
239
|
+
sample_sheet_name=sample_sheet,
|
|
240
|
+
target_sheet_name=sheet_name,
|
|
241
|
+
module_code=module_code,
|
|
242
|
+
module_name=module_name,
|
|
243
|
+
author=author
|
|
244
|
+
)
|
|
245
|
+
case_count = len([r for r in rows if r.get('type') == 'case'])
|
|
246
|
+
return f"Successfully exported {case_count} test cases into '{res_path}' using template '{sample_sheet}'."
|
|
247
|
+
else:
|
|
248
|
+
# Fallback to standard 12-column layout
|
|
249
|
+
import tempfile
|
|
250
|
+
with tempfile.NamedTemporaryFile("w", encoding="utf-8", suffix=".md", delete=False) as tf:
|
|
251
|
+
tf.write(markdown_content)
|
|
252
|
+
tf_path = tf.name
|
|
253
|
+
try:
|
|
254
|
+
try:
|
|
255
|
+
import md_to_xlsx
|
|
256
|
+
except ImportError:
|
|
257
|
+
from tools import md_to_xlsx
|
|
258
|
+
md_to_xlsx.convert_markdown_to_xlsx(tf_path, str(valid_output), sheet_name=sheet_name or "Test Cases")
|
|
259
|
+
finally:
|
|
260
|
+
if os.path.exists(tf_path):
|
|
261
|
+
os.unlink(tf_path)
|
|
262
|
+
return f"Successfully exported to '{valid_output}' using Hub default 12-column layout."
|
|
263
|
+
|
|
264
|
+
raise ValueError(f"Unknown MCP Excel tool: {name}")
|
|
265
|
+
|
|
266
|
+
|
|
267
|
+
MCP_MANIFEST = {
|
|
268
|
+
"tools": [
|
|
269
|
+
{
|
|
270
|
+
"name": "list_excel_sheets",
|
|
271
|
+
"description": "Lists all worksheet names present in a Microsoft Excel (.xlsx) file.",
|
|
272
|
+
"inputSchema": {
|
|
273
|
+
"type": "object",
|
|
274
|
+
"properties": {
|
|
275
|
+
"file_path": {"type": "string", "description": "Absolute or relative path to the .xlsx file"}
|
|
276
|
+
},
|
|
277
|
+
"required": ["file_path"]
|
|
278
|
+
}
|
|
279
|
+
},
|
|
280
|
+
{
|
|
281
|
+
"name": "read_excel_sheet",
|
|
282
|
+
"description": "Reads and displays tabular rows from an Excel worksheet formatted as a Markdown table.",
|
|
283
|
+
"inputSchema": {
|
|
284
|
+
"type": "object",
|
|
285
|
+
"properties": {
|
|
286
|
+
"file_path": {"type": "string", "description": "Path to the .xlsx file"},
|
|
287
|
+
"sheet_name": {"type": "string", "description": "Optional name of the worksheet to read"},
|
|
288
|
+
"max_rows": {"type": "integer", "description": "Maximum number of rows to retrieve (default: 50)"}
|
|
289
|
+
},
|
|
290
|
+
"required": ["file_path"]
|
|
291
|
+
}
|
|
292
|
+
},
|
|
293
|
+
{
|
|
294
|
+
"name": "export_testcases_to_excel",
|
|
295
|
+
"description": "Exports test cases into an Excel workbook (.xlsx). If a project template (.synapse.json or template_path) is configured, it clones the corporate template preserving headers, styling, and formulas. Otherwise, it generates the Hub 12-column standard layout.",
|
|
296
|
+
"inputSchema": {
|
|
297
|
+
"type": "object",
|
|
298
|
+
"properties": {
|
|
299
|
+
"markdown_content": {"type": "string", "description": "Markdown test case content or table"},
|
|
300
|
+
"output_path": {"type": "string", "description": "Output path for the generated .xlsx file"},
|
|
301
|
+
"sheet_name": {"type": "string", "description": "Name for the worksheet (e.g. feature name)"},
|
|
302
|
+
"template_path": {"type": "string", "description": "Optional path to template .xlsx file (overrides .synapse.json)"},
|
|
303
|
+
"sample_sheet": {"type": "string", "description": "Optional sheet in template to clone (defaults to .synapse.json or first sheet)"},
|
|
304
|
+
"module_code": {"type": "string", "description": "Module code (e.g. TC_MOD)"},
|
|
305
|
+
"module_name": {"type": "string", "description": "Module title in Vietnamese or English"},
|
|
306
|
+
"author": {"type": "string", "description": "Author name"}
|
|
307
|
+
},
|
|
308
|
+
"required": ["markdown_content", "output_path"]
|
|
309
|
+
}
|
|
310
|
+
}
|
|
311
|
+
]
|
|
312
|
+
}
|
|
313
|
+
|
|
314
|
+
|
|
315
|
+
MCP_EXCEL_TOOL_NAMES = {t["name"] for t in MCP_MANIFEST["tools"]}
|
|
316
|
+
|
|
317
|
+
|
|
318
|
+
def process_message(msg: Any) -> Optional[Dict[str, Any]]:
|
|
319
|
+
"""JSON-RPC 2.0 message handler for Excel MCP."""
|
|
320
|
+
if not isinstance(msg, dict):
|
|
321
|
+
return jsonrpc_error_response(INVALID_REQUEST, "Invalid Request: message must be a JSON object", req_id=None)
|
|
322
|
+
|
|
323
|
+
msg_id = msg.get("id")
|
|
324
|
+
|
|
325
|
+
if msg.get("jsonrpc") != "2.0":
|
|
326
|
+
return jsonrpc_error_response(INVALID_REQUEST, "Invalid Request: 'jsonrpc' must be exactly '2.0'", req_id=msg_id)
|
|
327
|
+
|
|
328
|
+
method = msg.get("method")
|
|
329
|
+
if not isinstance(method, str) or not method:
|
|
330
|
+
return jsonrpc_error_response(INVALID_REQUEST, "Invalid Request: 'method' must be a non-empty string", req_id=msg_id)
|
|
331
|
+
|
|
332
|
+
# Notifications handling (no response per JSON-RPC 2.0 spec)
|
|
333
|
+
if method in ("notifications/initialized", "initialized") or method.startswith("notifications/"):
|
|
334
|
+
return None
|
|
335
|
+
if msg_id is None:
|
|
336
|
+
return None
|
|
337
|
+
|
|
338
|
+
if method == "initialize":
|
|
339
|
+
return {
|
|
340
|
+
"jsonrpc": "2.0",
|
|
341
|
+
"id": msg_id,
|
|
342
|
+
"result": {
|
|
343
|
+
"protocolVersion": "2024-11-05",
|
|
344
|
+
"capabilities": {"tools": {}},
|
|
345
|
+
"serverInfo": {"name": "synapse-mcp-excel", "version": SERVER_VERSION}
|
|
346
|
+
}
|
|
347
|
+
}
|
|
348
|
+
elif method == "ping":
|
|
349
|
+
return {"jsonrpc": "2.0", "id": msg_id, "result": {}}
|
|
350
|
+
elif method == "tools/list":
|
|
351
|
+
return {
|
|
352
|
+
"jsonrpc": "2.0",
|
|
353
|
+
"id": msg_id,
|
|
354
|
+
"result": MCP_MANIFEST
|
|
355
|
+
}
|
|
356
|
+
elif method == "tools/call":
|
|
357
|
+
params = msg.get("params")
|
|
358
|
+
if not isinstance(params, dict):
|
|
359
|
+
return jsonrpc_error_response(INVALID_PARAMS, "Invalid params: 'params' must be a dictionary", req_id=msg_id)
|
|
360
|
+
|
|
361
|
+
tool_name = params.get("name")
|
|
362
|
+
if not isinstance(tool_name, str) or not tool_name:
|
|
363
|
+
return jsonrpc_error_response(INVALID_PARAMS, "Invalid params: tool 'name' must be a non-empty string", req_id=msg_id)
|
|
364
|
+
|
|
365
|
+
if tool_name not in MCP_EXCEL_TOOL_NAMES:
|
|
366
|
+
return jsonrpc_error_response(METHOD_NOT_FOUND, f"Method not found: Unknown tool '{tool_name}'", req_id=msg_id)
|
|
367
|
+
|
|
368
|
+
args = params.get("arguments")
|
|
369
|
+
if args is None:
|
|
370
|
+
args = {}
|
|
371
|
+
if not isinstance(args, dict):
|
|
372
|
+
return jsonrpc_error_response(INVALID_PARAMS, "Invalid params: 'arguments' must be a dictionary", req_id=msg_id)
|
|
373
|
+
|
|
374
|
+
# Validate mandatory tool arguments
|
|
375
|
+
if tool_name in ("list_excel_sheets", "read_excel_sheet"):
|
|
376
|
+
file_path = args.get("file_path")
|
|
377
|
+
if not file_path or not isinstance(file_path, str):
|
|
378
|
+
return jsonrpc_error_response(INVALID_PARAMS, "Invalid params: 'file_path' is required and must be a non-empty string", req_id=msg_id)
|
|
379
|
+
elif tool_name == "export_testcases_to_excel":
|
|
380
|
+
if "markdown_content" not in args or not isinstance(args["markdown_content"], str):
|
|
381
|
+
return jsonrpc_error_response(INVALID_PARAMS, "Invalid params: 'markdown_content' is required and must be a string", req_id=msg_id)
|
|
382
|
+
if "output_path" not in args or not isinstance(args["output_path"], str) or not args["output_path"].strip():
|
|
383
|
+
return jsonrpc_error_response(INVALID_PARAMS, "Invalid params: 'output_path' is required and must be a non-empty string", req_id=msg_id)
|
|
384
|
+
|
|
385
|
+
try:
|
|
386
|
+
content = handle_tool_call(tool_name, args)
|
|
387
|
+
return {
|
|
388
|
+
"jsonrpc": "2.0",
|
|
389
|
+
"id": msg_id,
|
|
390
|
+
"result": {"content": [{"type": "text", "text": content}], "isError": False}
|
|
391
|
+
}
|
|
392
|
+
except PermissionError as e:
|
|
393
|
+
return jsonrpc_error_response(INVALID_PARAMS, f"Invalid params (traversal or permission denied): {e}", req_id=msg_id)
|
|
394
|
+
except (ValueError, FileNotFoundError) as e:
|
|
395
|
+
return {
|
|
396
|
+
"jsonrpc": "2.0",
|
|
397
|
+
"id": msg_id,
|
|
398
|
+
"result": {"content": [{"type": "text", "text": f"Error: {e}"}], "isError": True}
|
|
399
|
+
}
|
|
400
|
+
except Exception as e:
|
|
401
|
+
return jsonrpc_error_response(INTERNAL_ERROR, f"Internal error: {e}", req_id=msg_id)
|
|
402
|
+
|
|
403
|
+
return jsonrpc_error_response(METHOD_NOT_FOUND, f"Method not found: '{method}'", req_id=msg_id)
|
|
404
|
+
|
|
405
|
+
|
|
406
|
+
def main():
|
|
407
|
+
"""Main stdio loop for JSON-RPC 2.0 communication."""
|
|
408
|
+
if len(sys.argv) > 1 and any(arg in sys.argv for arg in ("-h", "--help")):
|
|
409
|
+
print("Usage: python3 tools/mcp_excel_server.py")
|
|
410
|
+
print("Model Context Protocol (MCP) server providing Excel automation tools over stdio.")
|
|
411
|
+
print("Supported operations: read_sheet, write_sheet, get_metadata, run_audit")
|
|
412
|
+
sys.exit(0)
|
|
413
|
+
|
|
414
|
+
for line in sys.stdin:
|
|
415
|
+
line = line.strip()
|
|
416
|
+
if not line:
|
|
417
|
+
continue
|
|
418
|
+
req_id = None
|
|
419
|
+
try:
|
|
420
|
+
try:
|
|
421
|
+
req = json.loads(line)
|
|
422
|
+
if isinstance(req, dict):
|
|
423
|
+
req_id = req.get("id")
|
|
424
|
+
except Exception as e:
|
|
425
|
+
err_resp = jsonrpc_error_response(PARSE_ERROR, f"Parse error: {e}", req_id=None)
|
|
426
|
+
sys.stdout.write(json.dumps(err_resp) + "\n")
|
|
427
|
+
sys.stdout.flush()
|
|
428
|
+
continue
|
|
429
|
+
|
|
430
|
+
resp = process_message(req)
|
|
431
|
+
if resp is not None:
|
|
432
|
+
sys.stdout.write(json.dumps(resp) + "\n")
|
|
433
|
+
sys.stdout.flush()
|
|
434
|
+
except Exception as e:
|
|
435
|
+
err_resp = jsonrpc_error_response(INTERNAL_ERROR, f"Internal error: {e}", req_id=req_id)
|
|
436
|
+
sys.stdout.write(json.dumps(err_resp) + "\n")
|
|
437
|
+
sys.stdout.flush()
|
|
438
|
+
|
|
439
|
+
|
|
440
|
+
if __name__ == "__main__":
|
|
441
|
+
main()
|