mcp

GalaxyMCP Server is a TypeScript-based MCP server focused on persona management with optional JIRA integration. It lets you load, activate, and inspect different AI personas (e.g., Technical Analyst) and provides a suite of tools to manage personas and, when configured, interact with JIRA to create tickets, update tickets, add comments, and link items. The server exposes commands like list_personas, activate_persona, get_active_persona, deactivate_persona, get_persona_details, reload_personas, and, if JIRA is configured, tools such as get_jira_ticket, create_jira_ticket, create_jira_epic, update_jira_ticket, add_jira_comment, link_jira_story_to_parent, link_jira_epic_to_parent, and attach_file_to_jira. To integrate with Augment AI or similar tooling, run the MCP server via the node-based entry point (dist/index.js) and provide the appropriate environment variables for user identity and JIRA access. Once running, use the CLI or your integration to invoke list_personas and switch between personas to tailor responses and behavior to specific tasks or domains.

Prerequisites:

• Node.js v20.0.0 or higher
• npm v10.0.0 or higher
• TypeScript v5.0.0 or higher

Step-by-step installation:

1. Clone or download the repository and navigate to the project directory

cd /path/to/galaxymcp-server

2. Install dependencies

npm install

3. Build the TypeScript code

npm run build

4. Run the server locally (example)

npm start

Optional environment setup (for persona attribution and JIRA integration):

export GALAXY_USER="your-username"
export GALAXY_PERSONAS_DIR="/path/to/custom/personas" # optional
export JIRA_BASE_URL="https://your-company.atlassian.net" # optional
export JIRA_EMAIL="your-email@company.com" # optional
export JIRA_TOKEN="your-jira-api-token" # optional
export JIRA_SUB_COMPONENT="Galaxy-Core" # optional

5. Verify startup output

GalaxyMCP server running on stdio
Loaded persona: Technical Analyst (technical-analyst_20250714-130000_galaxymcp)

Tips and common considerations:

• JIRA integration is optional; if not configured, only persona management tools will be available.
• The server compiles to dist/index.js; ensure you build after any code changes.
• When using Augment AI or similar tools, ensure the MCP server path (dist/index.js) and environment variables are correctly provided in the MCP configuration.
• The GALAXY_USER environment variable helps attribute persona actions; keep it consistent across sessions for proper attribution.
• If you modify persona definitions, reload_personas to pick up changes from the filesystem.
• Check that the JIRA_TOKEN has appropriate permissions for the desired operations (create, update, attach, etc.).