📦
Aha Mcpy
Aha MCP FastMCP Version
0 installs
Trust: 34 — Low
Devtools
Ask AI about Aha Mcpy
Powered by Claude · Grounded in docs
I know everything about Aha Mcpy. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
Aha! MCP Server - Python FastMCP Implementation
A Python-based MCP server for interacting with Aha! API using FastMCP with HTTP streaming capabilities.
Features
- HTTP Streaming: Built with FastMCP for efficient HTTP streaming
- GraphQL Integration: Uses GraphQL to query Aha! API
- Three Main Tools:
get_record: Get features or requirements by reference numberget_page: Get pages with optional parent relationshipssearch_documents: Search for Aha! documents
Environment Variables
AHA_API_TOKEN: Your Aha! API token (required)AHA_DOMAIN: Your Aha! domain name (required)PORT: Server port (default: 9004)
Installation
pip install -r requirements.txt
Running
Local Development
# Set environment variables
export AHA_API_TOKEN="your_token_here"
export AHA_DOMAIN="your_domain_here"
# Run with HTTP streaming (default)
python main.py
# Or run with stdio transport
python main.py --transport stdio
Docker
# Build the image
docker build -t aha-mcp .
# Run the container
docker run -e AHA_API_TOKEN="your_token_here" -e AHA_DOMAIN="your_domain_here" -p 9004:9004 aha-mcp
Tools
get_record
Get an Aha! feature or requirement by reference number.
- Input: reference (string) - e.g., "DEVELOP-123" or "ADT-123-1"
- Output: JSON with name and description
get_page
Get an Aha! page by reference number with optional relationships.
- Input:
- reference (string) - e.g., "ABC-N-213"
- include_parent (boolean, optional) - Include parent page
- Output: JSON with page details, children, and optional parent
search_documents
Search for Aha! documents.
- Input:
- query (string) - Search query
- searchable_type (string, optional) - Document type (default: "Page")
- Output: JSON with search results and pagination info
Architecture
server.py: Main FastMCP server with tool definitionshandlers.py: Business logic for handling each toolqueries.py: GraphQL queries for Aha! APItypes.py: Python dataclasses for type safetymain.py: Entry point for running the server
Inspired from https://github.com/aha-develop/aha-mcp
