mcp

package
v0.11.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jul 25, 2026 License: MIT Imports: 21 Imported by: 0

Documentation

Overview

Package mcp provides MCP server integration for Aha Studio using OmniSkill.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func RunServer 

func RunServer(ctx context.Context, opts *ServerOptions) error

RunServer starts the MCP server.

Types

type AhaSkill 

type AhaSkill struct {
	skill.BaseSkill
	// contains filtered or unexported fields
}

AhaSkill implements the skill.Skill interface for Aha.io operations.

func NewAhaSkill 

func NewAhaSkill(cfg *Config) *AhaSkill

NewAhaSkill creates a new AhaSkill with the given configuration.

func (*AhaSkill) Close 

func (s *AhaSkill) Close() error

Close cleans up resources.

func (*AhaSkill) Description 

func (s *AhaSkill) Description() string

Description returns a human-readable description of the skill.

func (*AhaSkill) Init 

func (s *AhaSkill) Init(ctx context.Context) error

Init initializes the skill.

func (*AhaSkill) Name 

func (s *AhaSkill) Name() string

Name returns the skill identifier.

func (*AhaSkill) Tools 

func (s *AhaSkill) Tools() []skill.Tool

Tools returns the tools provided by this skill.

type Config 

type Config struct {
	// Subdomain is the Aha.io account subdomain.
	Subdomain string

	// APIKey is the Aha.io API key.
	APIKey string

	// DefaultProduct is the default product ID for queries.
	DefaultProduct string

	// BrowserEmail is the email for browser automation login.
	BrowserEmail string

	// BrowserPassword is the password for browser automation login.
	BrowserPassword string
}

Config holds configuration for the Aha MCP skill.

func ConfigFromEnv 

func ConfigFromEnv() (*Config, error)

ConfigFromEnv creates a Config from environment variables.

func (*Config) NewClient 

func (c *Config) NewClient() (*aha.Client, error)

NewClient creates an Aha API client from the config.

type ServerOptions 

type ServerOptions struct {
	// Transport is the transport mode: "stdio" or "http"
	Transport string

	// HTTPAddr is the HTTP server address (for http transport)
	HTTPAddr string

	// Config is the Aha configuration
	Config *Config
}

ServerOptions configures the MCP server.

type ToolHandlers 

type ToolHandlers struct {
	// contains filtered or unexported fields
}

ToolHandlers provides handler functions for Aha MCP tools.

func NewToolHandlers 

func NewToolHandlers(cfg *Config) *ToolHandlers

NewToolHandlers creates a new ToolHandlers instance.

func (*ToolHandlers) AddFeatureComment 

func (h *ToolHandlers) AddFeatureComment(ctx context.Context, params map[string]any) (any, error)

AddFeatureComment adds a comment to a feature.

func (*ToolHandlers) AddIdeaComment 

func (h *ToolHandlers) AddIdeaComment(ctx context.Context, params map[string]any) (any, error)

AddIdeaComment adds a comment to an idea.

func (*ToolHandlers) AssignFeatureRelease 

func (h *ToolHandlers) AssignFeatureRelease(ctx context.Context, params map[string]any) (any, error)

AssignFeatureRelease assigns a feature to a release.

func (*ToolHandlers) AssignUserToFeature 

func (h *ToolHandlers) AssignUserToFeature(ctx context.Context, params map[string]any) (any, error)

AssignUserToFeature assigns a user to a feature.

func (*ToolHandlers) BrowserCreateTemplate 

func (h *ToolHandlers) BrowserCreateTemplate(ctx context.Context, params map[string]any) (any, error)

BrowserCreateTemplate creates a strategic model template via browser automation.

func (*ToolHandlers) ChangeFeatureStatus 

func (h *ToolHandlers) ChangeFeatureStatus(ctx context.Context, params map[string]any) (any, error)

ChangeFeatureStatus changes the workflow status of a feature.

func (*ToolHandlers) CreateEpic added in v0.10.0 

func (h *ToolHandlers) CreateEpic(ctx context.Context, params map[string]any) (any, error)

CreateEpic creates a new epic in a release.

func (*ToolHandlers) CreateFeature 

func (h *ToolHandlers) CreateFeature(ctx context.Context, params map[string]any) (any, error)

CreateFeature creates a new feature.

func (*ToolHandlers) CreateGoal added in v0.10.0 

func (h *ToolHandlers) CreateGoal(ctx context.Context, params map[string]any) (any, error)

CreateGoal creates a new goal in a product.

func (*ToolHandlers) CreateInitiative added in v0.10.0 

func (h *ToolHandlers) CreateInitiative(ctx context.Context, params map[string]any) (any, error)

CreateInitiative creates a new initiative in a product.

func (*ToolHandlers) CreateProduct added in v0.10.0 

func (h *ToolHandlers) CreateProduct(ctx context.Context, params map[string]any) (any, error)

CreateProduct creates a new product.

func (*ToolHandlers) CreateRequirement added in v0.10.0 

func (h *ToolHandlers) CreateRequirement(ctx context.Context, params map[string]any) (any, error)

CreateRequirement creates a new requirement for a feature.

func (*ToolHandlers) CreateStrategicModel added in v0.10.0 

func (h *ToolHandlers) CreateStrategicModel(ctx context.Context, params map[string]any) (any, error)

CreateStrategicModel creates a new strategic model.

func (*ToolHandlers) DeleteComment added in v0.10.0 

func (h *ToolHandlers) DeleteComment(ctx context.Context, params map[string]any) (any, error)

DeleteComment deletes a comment.

func (*ToolHandlers) DeleteRequirement added in v0.10.0 

func (h *ToolHandlers) DeleteRequirement(ctx context.Context, params map[string]any) (any, error)

DeleteRequirement deletes a requirement.

func (*ToolHandlers) DescribeAQL 

func (h *ToolHandlers) DescribeAQL(ctx context.Context, params map[string]any) (any, error)

DescribeAQL returns AQL syntax help.

func (*ToolHandlers) GetComment 

func (h *ToolHandlers) GetComment(ctx context.Context, params map[string]any) (any, error)

GetComment retrieves a comment by ID.

func (*ToolHandlers) GetCurrentUser added in v0.10.0 

func (h *ToolHandlers) GetCurrentUser(ctx context.Context, params map[string]any) (any, error)

GetCurrentUser returns the authenticated user.

func (*ToolHandlers) GetEpic 

func (h *ToolHandlers) GetEpic(ctx context.Context, params map[string]any) (any, error)

GetEpic retrieves an epic by ID.

func (*ToolHandlers) GetFeature 

func (h *ToolHandlers) GetFeature(ctx context.Context, params map[string]any) (any, error)

GetFeature retrieves a feature by reference number.

func (*ToolHandlers) GetGoal 

func (h *ToolHandlers) GetGoal(ctx context.Context, params map[string]any) (any, error)

GetGoal retrieves a goal by ID.

func (*ToolHandlers) GetIdea 

func (h *ToolHandlers) GetIdea(ctx context.Context, params map[string]any) (any, error)

GetIdea retrieves an idea by reference number.

func (*ToolHandlers) GetInitiative 

func (h *ToolHandlers) GetInitiative(ctx context.Context, params map[string]any) (any, error)

GetInitiative retrieves an initiative by reference number.

func (*ToolHandlers) GetKeyResult 

func (h *ToolHandlers) GetKeyResult(ctx context.Context, params map[string]any) (any, error)

GetKeyResult retrieves a key result by ID.

func (*ToolHandlers) GetPersona 

func (h *ToolHandlers) GetPersona(ctx context.Context, params map[string]any) (any, error)

GetPersona retrieves a persona by ID.

func (*ToolHandlers) GetRelease 

func (h *ToolHandlers) GetRelease(ctx context.Context, params map[string]any) (any, error)

GetRelease retrieves a release by reference number.

func (*ToolHandlers) GetRequirement 

func (h *ToolHandlers) GetRequirement(ctx context.Context, params map[string]any) (any, error)

GetRequirement retrieves a requirement by ID.

func (*ToolHandlers) GetStrategicModel added in v0.10.0 

func (h *ToolHandlers) GetStrategicModel(ctx context.Context, params map[string]any) (any, error)

GetStrategicModel retrieves a strategic model by ID.

func (*ToolHandlers) GetTeam 

func (h *ToolHandlers) GetTeam(ctx context.Context, params map[string]any) (any, error)

GetTeam retrieves a team by ID.

func (*ToolHandlers) GetUser 

func (h *ToolHandlers) GetUser(ctx context.Context, params map[string]any) (any, error)

GetUser retrieves a user by ID.

func (*ToolHandlers) GetWorkflow 

func (h *ToolHandlers) GetWorkflow(ctx context.Context, params map[string]any) (any, error)

GetWorkflow retrieves a workflow by ID.

func (*ToolHandlers) GraphFindPath 

func (h *ToolHandlers) GraphFindPath(ctx context.Context, params map[string]any) (any, error)

GraphFindPath finds the shortest path between two entities.

func (*ToolHandlers) GraphInitiativeImpact 

func (h *ToolHandlers) GraphInitiativeImpact(ctx context.Context, params map[string]any) (any, error)

GraphInitiativeImpact returns the impact analysis of an initiative.

func (*ToolHandlers) GraphQuery 

func (h *ToolHandlers) GraphQuery(ctx context.Context, params map[string]any) (any, error)

GraphQuery executes a Cypher query against Neo4j.

func (*ToolHandlers) GraphReleaseDeps 

func (h *ToolHandlers) GraphReleaseDeps(ctx context.Context, params map[string]any) (any, error)

GraphReleaseDeps returns feature dependencies for a release.

func (*ToolHandlers) GraphSearch 

func (h *ToolHandlers) GraphSearch(ctx context.Context, params map[string]any) (any, error)

GraphSearch performs full-text search across graph entities.

func (*ToolHandlers) GraphSync 

func (h *ToolHandlers) GraphSync(ctx context.Context, params map[string]any) (any, error)

GraphSync syncs data to Neo4j graph database.

func (*ToolHandlers) Init 

func (h *ToolHandlers) Init(ctx context.Context) error

Init initializes the handlers with an Aha client.

func (*ToolHandlers) ListCustomFieldDefinitions added in v0.10.0 

func (h *ToolHandlers) ListCustomFieldDefinitions(ctx context.Context, params map[string]any) (any, error)

ListCustomFieldDefinitions lists all custom field definitions, optionally filtered by product.

func (*ToolHandlers) ListCustomFieldOptions added in v0.10.0 

func (h *ToolHandlers) ListCustomFieldOptions(ctx context.Context, params map[string]any) (any, error)

ListCustomFieldOptions lists options for a select custom field.

func (*ToolHandlers) ListEpicComments added in v0.10.0 

func (h *ToolHandlers) ListEpicComments(ctx context.Context, params map[string]any) (any, error)

ListEpicComments lists comments for an epic.

func (*ToolHandlers) ListEpics added in v0.10.0 

func (h *ToolHandlers) ListEpics(ctx context.Context, params map[string]any) (any, error)

ListEpics lists epics with optional filtering.

func (*ToolHandlers) ListFeatureComments added in v0.10.0 

func (h *ToolHandlers) ListFeatureComments(ctx context.Context, params map[string]any) (any, error)

ListFeatureComments lists comments for a feature.

func (*ToolHandlers) ListFeatureRequirements added in v0.10.0 

func (h *ToolHandlers) ListFeatureRequirements(ctx context.Context, params map[string]any) (any, error)

ListFeatureRequirements lists requirements for a specific feature.

func (*ToolHandlers) ListFeatures added in v0.10.0 

func (h *ToolHandlers) ListFeatures(ctx context.Context, params map[string]any) (any, error)

ListFeatures lists features with optional filtering.

func (*ToolHandlers) ListGoals added in v0.10.0 

func (h *ToolHandlers) ListGoals(ctx context.Context, params map[string]any) (any, error)

ListGoals lists goals with optional filtering.

func (*ToolHandlers) ListIdeaComments added in v0.10.0 

func (h *ToolHandlers) ListIdeaComments(ctx context.Context, params map[string]any) (any, error)

ListIdeaComments lists comments for an idea.

func (*ToolHandlers) ListIdeas 

func (h *ToolHandlers) ListIdeas(ctx context.Context, params map[string]any) (any, error)

ListIdeas lists ideas with optional filtering and pagination.

func (*ToolHandlers) ListInitiatives added in v0.10.0 

func (h *ToolHandlers) ListInitiatives(ctx context.Context, params map[string]any) (any, error)

ListInitiatives lists initiatives with optional filtering.

func (*ToolHandlers) ListPredefinedTemplates 

func (h *ToolHandlers) ListPredefinedTemplates(ctx context.Context, params map[string]any) (any, error)

ListPredefinedTemplates returns all available strategic model templates.

func (*ToolHandlers) ListProductEpics added in v0.10.0 

func (h *ToolHandlers) ListProductEpics(ctx context.Context, params map[string]any) (any, error)

ListProductEpics lists epics for a specific product.

func (*ToolHandlers) ListProductGoals added in v0.10.0 

func (h *ToolHandlers) ListProductGoals(ctx context.Context, params map[string]any) (any, error)

ListProductGoals lists goals for a specific product.

func (*ToolHandlers) ListProductInitiatives added in v0.10.0 

func (h *ToolHandlers) ListProductInitiatives(ctx context.Context, params map[string]any) (any, error)

ListProductInitiatives lists initiatives for a specific product.

func (*ToolHandlers) ListProductStrategicModels added in v0.10.0 

func (h *ToolHandlers) ListProductStrategicModels(ctx context.Context, params map[string]any) (any, error)

ListProductStrategicModels lists strategic models for a product.

func (*ToolHandlers) ListProducts 

func (h *ToolHandlers) ListProducts(ctx context.Context, params map[string]any) (any, error)

ListProducts lists all accessible Aha.io products.

func (*ToolHandlers) ListReleaseFeatures added in v0.10.0 

func (h *ToolHandlers) ListReleaseFeatures(ctx context.Context, params map[string]any) (any, error)

ListReleaseFeatures lists features for a specific release.

func (*ToolHandlers) ListReleases 

func (h *ToolHandlers) ListReleases(ctx context.Context, params map[string]any) (any, error)

ListReleases lists all releases for a product.

func (*ToolHandlers) ListStrategicModels added in v0.10.0 

func (h *ToolHandlers) ListStrategicModels(ctx context.Context, params map[string]any) (any, error)

ListStrategicModels lists strategic models.

func (*ToolHandlers) ListUsers added in v0.10.0 

func (h *ToolHandlers) ListUsers(ctx context.Context, params map[string]any) (any, error)

ListUsers lists workspace users.

func (*ToolHandlers) ListWorkflowStatuses 

func (h *ToolHandlers) ListWorkflowStatuses(ctx context.Context, params map[string]any) (any, error)

ListWorkflowStatuses lists all workflow statuses for a product.

func (*ToolHandlers) Query 

func (h *ToolHandlers) Query(ctx context.Context, params map[string]any) (any, error)

Query executes an AQL query and returns results.

func (*ToolHandlers) SearchDocuments 

func (h *ToolHandlers) SearchDocuments(ctx context.Context, params map[string]any) (any, error)

SearchDocuments searches for Aha! documents using GraphQL.

func (*ToolHandlers) UpdateComment added in v0.10.0 

func (h *ToolHandlers) UpdateComment(ctx context.Context, params map[string]any) (any, error)

UpdateComment updates an existing comment.

func (*ToolHandlers) UpdateEpic added in v0.10.0 

func (h *ToolHandlers) UpdateEpic(ctx context.Context, params map[string]any) (any, error)

UpdateEpic updates an epic's fields.

func (*ToolHandlers) UpdateFeature added in v0.10.0 

func (h *ToolHandlers) UpdateFeature(ctx context.Context, params map[string]any) (any, error)

UpdateFeature updates a feature's fields (general update tool).

func (*ToolHandlers) UpdateGoal added in v0.10.0 

func (h *ToolHandlers) UpdateGoal(ctx context.Context, params map[string]any) (any, error)

UpdateGoal updates a goal's fields.

func (*ToolHandlers) UpdateIdea added in v0.10.0 

func (h *ToolHandlers) UpdateIdea(ctx context.Context, params map[string]any) (any, error)

UpdateIdea updates an idea's fields.

func (*ToolHandlers) UpdateInitiative added in v0.10.0 

func (h *ToolHandlers) UpdateInitiative(ctx context.Context, params map[string]any) (any, error)

UpdateInitiative updates an initiative's fields.

func (*ToolHandlers) UpdateProduct added in v0.10.0 

func (h *ToolHandlers) UpdateProduct(ctx context.Context, params map[string]any) (any, error)

UpdateProduct updates an existing product.

func (*ToolHandlers) UpdateRelease added in v0.10.0 

func (h *ToolHandlers) UpdateRelease(ctx context.Context, params map[string]any) (any, error)

UpdateRelease updates a release's fields.

func (*ToolHandlers) UpdateRequirement added in v0.10.0 

func (h *ToolHandlers) UpdateRequirement(ctx context.Context, params map[string]any) (any, error)

UpdateRequirement updates a requirement's fields.

func (*ToolHandlers) UpdateStrategicModel added in v0.10.0 

func (h *ToolHandlers) UpdateStrategicModel(ctx context.Context, params map[string]any) (any, error)

UpdateStrategicModel updates a strategic model.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.