Metadata-Version: 2.4
Name: stash-mcp
Version: 1.0.0
Summary: A Model Context Protocol (MCP) server for Stash issue analysis and task management
Project-URL: Homepage, https://usestash.com
Project-URL: Documentation, https://docs.usestash.com/mcp/stash-mcp
Author-email: Stash Team <ayberk@usestash.com>
Maintainer-email: Stash Team <ayberk@usestash.com>
License: MIT
License-File: LICENSE
Keywords: ai,claude-code,copilot,cursor,issue-analysis,llm,mcp,model-context-protocol,stash,task-management
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Groupware
Classifier: Topic :: Software Development :: Bug Tracking
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: httpx>=0.25.0
Requires-Dist: mcp>=1.13.0
Requires-Dist: python-dotenv>=1.0.0
Description-Content-Type: text/markdown

# Stash MCP Server

[![PyPI version](https://badge.fury.io/py/stash-mcp.svg)](https://badge.fury.io/py/stash-mcp)
[![Python versions](https://img.shields.io/pypi/pyversions/stash-mcp.svg)](https://pypi.org/project/stash-mcp/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

A Model Context Protocol (MCP) server for Stash issue analysis. This server enables AI assistants to interact with your Stash instance to analyze issues, find similar content, and identify subject matter experts.

## Features

- **Issue Analysis**: Get detailed analysis for specific issues including similar content discovery
- **Task Management**: List and manage tasks assigned to the authenticated user
- **Secure Authentication**: Uses MCP tokens for secure API access

## Configuration

The server requires the following environment variables:

- `STASH_API_BASE`: Base URL for your Stash API
- `STASH_MCP_TOKEN`: Your Stash MCP authentication token

You can get these environment variables from your [Stash account](https://usestash.com).

### With Copilot, Cursor, or Claude Code

Add this to your IDE MCP configuration file:

```json
{
  "mcpServers": {
    "stash": {
      "command": "uvx",
      "args": ["stash-mcp"],
      "env": {
        "STASH_API_BASE": "stash-api-base-url",
        "STASH_MCP_TOKEN": "your-mcp-token-here"
      }
    }
  }
}
```

### Available Tools

#### `list_my_tasks`

Lists all tasks assigned to the authenticated user, grouped by categories.

#### `get_issue_analysis`

Get detailed analysis for a specific issue including:

- Similar issues
- Related documents
- Relevant code files
- Subject matter experts

## Requirements

- Python 3.10 or higher
- Valid [Stash account](https://usestash.com) with MCP access
- Network access to your Stash instance

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Support

For support and questions, See [Stash Documentation](https://docs.usestash.com/mcp/stash-mcp).
