jira-mcp

Vrshn Claude Marketplace

A collection of MCP (Model Context Protocol) server plugins for Claude Code.

Available Plugins

Plugin	Description
atlassian-mcp	Jira, Confluence, and Bitbucket integration - search, read, create, and manage issues, pages, and pull requests
talk2docs	Local document semantic search using ChromaDB and Ollama embeddings

Quick Start

Step 1: Add This Marketplace to Claude Code

Open or create ~/.claude/settings.json and add the marketplace configuration:

{
  "marketplaces": [
    {
      "name": "Vrshn Marketplace",
      "url": "https://bitbucket.itg.ti.com/projects/vrshn/repos/vrshn-claude-marketplace/raw/.claude-plugin/marketplace.json?at=refs/heads/master"
    }
  ]
}

If you already have other settings in the file, just add the marketplaces array alongside them.

Step 2: Clone the Repository

git clone ssh://git@bitbucket.itg.ti.com/vrshn/vrshn-claude-marketplace.git
cd vrshn-claude-marketplace

Step 3: Install a Plugin

Choose which plugin to install and follow the setup instructions below.

---

Plugin Setup Instructions

Atlassian MCP Setup

This plugin provides tools for Jira, Confluence, and Bitbucket.

1. Install Dependencies

cd atlassian-mcp
python -m venv venv
source venv/bin/activate  # Linux/Mac
# or: venv\Scripts\activate  # Windows
pip install -r requirements.txt

2. Configure Credentials

Create the credentials file:

mkdir -p ~/.config/atlassian
chmod 700 ~/.config/atlassian

cat > ~/.config/atlassian/.env << 'EOF'
# Jira credentials
JIRA_URL=https://jira.your-company.com
JIRA_USERNAME=your_username
JIRA_TOKEN=your_personal_access_token

# Confluence credentials
CONFLUENCE_URL=https://confluence.your-company.com
CONFLUENCE_USERNAME=your_username
CONFLUENCE_TOKEN=your_personal_access_token

# Bitbucket credentials
BITBUCKET_URL=https://bitbucket.your-company.com
BITBUCKET_USERNAME=your_username
BITBUCKET_TOKEN=your_personal_access_token
EOF

chmod 600 ~/.config/atlassian/.env

3. Get Personal Access Tokens

Jira:

1. Go to Avatar > Profile > Personal Access Tokens
2. Click "Create token"
3. Copy the token value

Confluence:

1. Go to Avatar > Settings > Personal Access Tokens
2. Click "Create token"
3. Copy the token value

Bitbucket:

1. Go to Avatar > Manage Account > Personal Access Tokens
2. Click "Create token"
3. Select "Repository Read" permission (and Write if needed)
4. Copy the token value

4. Register with Claude Code

# Make sure you're in the atlassian-mcp directory with venv activated
claude mcp add --transport stdio --scope user atlassian \
  --env ATLASSIAN_CONFIG=~/.config/atlassian/.env \
  -- $(pwd)/venv/bin/python $(pwd)/mcp_server.py

5. Verify Installation

Restart Claude Code and try:

• "Get issue PROJ-123 from Jira"
• "Search for open bugs assigned to me"
• "Get the latest PR in my-project/my-repo"

---

Talk2Docs Setup

This plugin provides semantic search across local documents.

1. Install Ollama

# Install Ollama (Linux)
curl -fsSL https://ollama.com/install.sh | sh

# Pull the embedding model
ollama pull nomic-embed-text

# Start Ollama service
ollama serve

2. Install Dependencies

cd talk2docs
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

3. Index Your Documents

# Index a folder of documents
python index.py /path/to/your/documents

# Index specific files
python index.py file1.pdf file2.docx

# Force re-index existing documents
python index.py --force /path/to/documents

# Filter by extension
python index.py /path/to/documents --ext pdf docx

# Use parallel processing for faster indexing
python index.py /path/to/documents -p 4 -w 8

4. Register with Claude Code

# Make sure you're in the talk2docs directory with venv activated
claude mcp add --transport stdio --scope user ldoc-search \
  --env CHROMA_DB_PATH=$(pwd)/chroma_db \
  --env OLLAMA_MODEL=nomic-embed-text \
  -- $(pwd)/venv/bin/python $(pwd)/mcp_server.py

5. Verify Installation

Restart Claude Code and try:

• "Search my documents for deployment guide"
• "List all indexed documents"
• "Get index statistics"

---

Managing MCP Servers

# List registered MCP servers
claude mcp list

# Remove an MCP server
claude mcp remove atlassian
claude mcp remove ldoc-search

# Check MCP server status
claude mcp status

Plugin Details

Atlassian MCP Tools

Jira:

• jira_get_issue - Get issue details by key or URL
• jira_search - Search issues using JQL
• jira_create_issue - Create new issues
• jira_add_comment - Add comments to issues
• jira_transition_issue - Change issue status