nys

This MCP server (nys) integrates with the Mira workflow to enable SPARC-like task progressions for NYS GIS tasks. It exposes capabilities via an MCP interface that Mira can connect to over HTTP/WebSocket or via a local stdio binary. Once connected, you can list available tools, send prompts, and run workflow actions that align with the Design, Build, and Debug phases. Use the built-in MCP commands to switch modes, execute prompts, and collect logs to drive the issue-backed development process through the three-mode lifecycle. The server’s tools support tasks such as feature extraction, specification generation, code scaffolding, and debugging assistance, all traceable to specific issue folders in your workspace.

Prerequisites:

• Node.js and npm installed on your machine
• Access to an MCP server package named adorsys-gis-nys (or the ability to install via npx)

Installation steps:

1. Ensure you have Node.js and npm installed
   • Check: node -v and npm -v
2. Install or run the MCP server package via npx (recommended for quick start)
   • npx -y adorsys-gis-nys
3. Alternatively, install as a local package (if you prefer):
   • npm install -g adorsys-gis-nys
   • nys-server --help # if the package exposes a CLI entry point named nys-server
4. Start the server if a binary is provided locally:
   • ./path/to/nys-server # or npm run start if defined by the package
5. In Mira, configure the MCP connection to point at the running server (HTTP/WebSocket) or to the stdio binary as documented

Prerequisites summary: Node.js, npm, and access to the adorsys-gis-nys MCP server package or binary.

Tips and common issues:

• If using HTTP/WebSocket, ensure the server endpoint is reachable from your development environment and that any required API keys or tokens are provided via environment variables or Mira settings.
• For stdio mode, ensure the MCP binary is executable and that environment variables (e.g., GITHUB_PERSONAL_ACCESS_TOKEN, GITHUB_TOKEN, API_KEY) are correctly forwarded.
• Keep the .nys/ directory in your workspace to persist workflow state across sessions.
• If you run into tool discovery issues, use the MCP: List Available Tools command to verify what the server exposes and ensure the server is running before attempting prompt execution.
• When using npx to run adorsys-gis-nys, you may want to pin a specific version to avoid unexpected updates.