atxtechbro / atxtechbro/dotfiles

Strip atlassian-mcp-server to bare bones for local use

Open
#678 1 comment 0 reactions 0 assignees View on GitHub
cleanup enhancement mcp
Dominant language
Shell
Stars
27
Forks
2
PR merge metrics
No merged PRs in 30d

Description

## Issue Description

The forked atlassian-mcp-server contains many files that aren't essential for local-only usage. To reduce token usage when AI agents read the codebase, we should strip it down to its bare functional bones.

## Files to Remove

### Distribution/Publishing Infrastructure
- `Dockerfile` - containerization not needed for local use
- `smithery.yaml` - Smithery.ai registry configuration
- PyPI metadata in `pyproject.toml` (keep only dependency management)
- `uv.lock` - 251KB dependency lock file

### Community/Documentation Files
- `CONTRIBUTING.md` - contributor guidelines
- `SECURITY.md` - security policy
- `AGENTS.md` - AI agents documentation
- Original `README.md` (32KB) - we have `README.dotfiles.md`

### Testing Infrastructure (if not needed)
- `tests/` directory and all test files
- Test dependencies in `pyproject.toml`
- Any pytest configuration files

## Additional Investigation Needed

While removing the above files, also search for and consider removing:

1. **CI/CD configurations**:
- Any GitHub Actions workflows
- GitLab CI files
- Other CI configuration files

2. **Documentation**:
- API documentation files
- Example configurations (except those needed locally)
- Changelog files
- Any `docs/` directories

3. **Development tools**:
- Linting configurations (`.flake8`, `.pylintrc`, etc.)
- Pre-commit hooks
- Editor-specific files beyond `.gitignore`
- Makefile (if not used for local setup)

4. **Package metadata**:
- `MANIFEST.in`
- `setup.cfg`
- Any `*.egg-info` directories
- Version files not used by the code

5. **Example/Demo files**:
- Sample configurations
- Demo scripts
- Tutorial content

## Goal

Keep only the absolute minimum needed to:
- Run the MCP server locally
- Install dependencies
- Configure for personal Atlassian instances

Essential files to keep:
- `src/` directory (core functionality)
- Minimal `pyproject.toml` (dependencies only)
- `setup.sh` and essential scripts
- `.gitignore`
- `LICENSE`
- `README.dotfiles.md` or a minimal README

## Benefits

- Significantly reduce token usage for AI agents
- Faster codebase comprehension
- Less clutter when navigating
- Focus on actual functionality

## Context

This follows the principle of "subtraction creates value" - removing non-essential files makes the codebase more focused and efficient for its intended local-only use case.

Contributor guide

No contributing guide indexed for this repository

Research direction

Inventory the repository against the listed removal candidates, starting with pyproject.toml, setup.sh, the src/ directory, and any CI, documentation, testing, or packaging files found by the investigation. Check which files are required to install, configure, and run the Atlassian MCP server locally. Done means local setup still works with only the retained essentials and unnecessary distribution, community, testing, and development files are removed.

Written by the indexing model from the issue text.

Assessment

Tech stack
python, shell
Domain
backend, tooling
Issue type
Refactor
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.