Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
766d559
chore: add .npmignore for cleaner npm package
AbdallahAHO Jul 16, 2025
7ba82f4
chore(package): update bin path and repository url syntax
AbdallahAHO Jul 16, 2025
f770b57
feat: implement automated release workflow
AbdallahAHO Jul 16, 2025
760b687
feat: extend CI workflow to run on every push to main branches
AbdallahAHO Jul 16, 2025
ddef0d3
chore: add missing newline at end of config file
AbdallahAHO Jul 16, 2025
d07d46b
feat: Automated Release Workflow
AbdallahAHO Jul 16, 2025
214080a
fix: add workflow permissions and create CHANGELOG.md
AbdallahAHO Jul 16, 2025
bfbf418
feat: add pre-commit hooks for formatting and linting
AbdallahAHO Jul 16, 2025
94214e2
fix: update release workflow to handle GitHub Actions PR permissions
AbdallahAHO Jul 16, 2025
e11d557
fix: use GitHub CLI for PR creation to avoid permissions issue
AbdallahAHO Jul 16, 2025
3c1028d
chore: remove redundant source file ignores from ignore configs
AbdallahAHO Jul 16, 2025
f13c918
ci: use environment vars for signing certificates
AbdallahAHO Jul 16, 2025
14a7d56
ci: update dxt command and remove signature verification
AbdallahAHO Jul 16, 2025
1c2ed9d
merge back main into develop after release
AbdallahAHO Jul 16, 2025
e666726
refactor(logger): defer logger initialization and file setup
AbdallahAHO Jul 16, 2025
a3216ae
Merge branch 'main' into develop
AbdallahAHO Jul 16, 2025
b709e8b
Deployment: Dockerfile and Smithery config (#6)
smithery[bot] Jul 18, 2025
30c72ed
Update smithery.yaml
AbdallahAHO Jul 18, 2025
23a4832
feat(config): add MCP initialization config handling and prioritizati…
AbdallahAHO Aug 5, 2025
7c8ed46
Merge branch 'main' into develop
AbdallahAHO Aug 11, 2025
cf395e9
ci: improve back-merge handling in release workflow
AbdallahAHO Aug 11, 2025
b3be9b1
refactor: reorder exports to improve consistency
AbdallahAHO Aug 11, 2025
5fdac61
feat(usergroups): add complete user group management domain
AbdallahAHO Aug 11, 2025
c7e9113
feat(teamusers): add domain with CLI, service, controller, formatter,…
AbdallahAHO Aug 11, 2025
532dcbc
feat(queuedprocesses): add domain for monitoring async operations
AbdallahAHO Aug 11, 2025
399c0a3
refactor(prompts): expand and restructure MCP prompts with detailed s…
AbdallahAHO Aug 11, 2025
8bbade5
feat(prompts): add workflows for post-upload and document extraction …
AbdallahAHO Aug 11, 2025
37e57c4
docs: update documentation
AbdallahAHO Aug 11, 2025
237233c
chore(release): prepare release v1.0.4
github-actions[bot] Aug 11, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
89 changes: 77 additions & 12 deletions .github/workflows/ci-semantic-release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -129,12 +129,46 @@ jobs:

### 📦 Installation

#### Desktop Extension (Recommended)
Download and double-click `lokalise-mcp-${{ steps.get-version.outputs.version }}.dxt` to install in Claude Desktop.
#### 1) Smithery (Recommended)
Automated install and configuration for popular MCP clients.

#### npm Package
```bash
npm install -g lokalise-mcp@${{ steps.get-version.outputs.version }}
# Claude Desktop
npx -y @smithery/cli install @AbdallahAHO/lokalise-mcp --client claude

# Cursor
npx -y @smithery/cli install @AbdallahAHO/lokalise-mcp --client cursor

# VS Code (Claude Code)
npx -y @smithery/cli install @AbdallahAHO/lokalise-mcp --client vscode

# Claude Code
claude mcp add --transport http abdallah-aho-lokalise-mcp "https://server.smithery.ai/@AbdallahAHO/lokalise-mcp/mcp"

# Gemini CLI
npx -y @smithery/cli install @AbdallahAHO/lokalise-mcp --client gemini
```

Inspect tools before installing:

```bash
npx -y @smithery/cli@latest inspect @AbdallahAHO/lokalise-mcp
```

#### 2) Claude Desktop Extension (DXT)
Download and double-click `lokalise-mcp-${{ steps.get-version.outputs.version }}.dxt` to install in ClaudeDesktop.
When prompted, enter your `LOKALISE_API_KEY`. Updates by installing the newer `.dxt`.

#### 3) Local (clone + run)
```bash
git clone https://github.com/AbdallahAHO/lokalise-mcp.git
cd lokalise-mcp
npm install

export LOKALISE_API_KEY="your-api-key-here"
npm run mcp:http # HTTP (SSE) at http://localhost:3000/mcp
# or
npm run mcp:stdio # STDIO
```

### 🔐 Verify Downloads
Expand All @@ -147,18 +181,49 @@ jobs:

# Step 11: Back-merge to develop
- name: Back-merge to develop
env:
GH_TOKEN: ${{ secrets.GH_PAT || secrets.GITHUB_TOKEN }}
run: |
# Fetch latest develop
git fetch origin develop:develop
# Fetch latest branches
git fetch origin develop:refs/remotes/origin/develop
git fetch origin main:refs/remotes/origin/main

# Checkout develop
git checkout develop
git checkout -B develop origin/develop

# Try to merge main
if git merge origin/main -m "chore: back-merge main to develop after v${{ steps.get-version.outputs.version }} release" --no-edit; then
echo "✅ Merge successful"
# Push to develop
git push origin develop
else
echo "⚠️ Merge conflicts detected. Creating a PR for manual resolution."

# Create a branch for the back-merge
BACKMERGE_BRANCH="backmerge/v${{ steps.get-version.outputs.version }}-to-develop"
git checkout -b "$BACKMERGE_BRANCH"

# Merge main
git merge main -m "chore: back-merge main to develop after v${{ steps.get-version.outputs.version }} release"
# Stage any resolved files (in case of partial auto-resolution)
git add -A

# Push to develop
git push origin develop
# Commit with conflicts markers if any
git commit -m "chore: back-merge main to develop after v${{ steps.get-version.outputs.version }} release (with conflicts)" || true

# Push the branch
git push origin "$BACKMERGE_BRANCH"

# Create a PR for manual resolution
gh pr create \
--title "Back-merge: v${{ steps.get-version.outputs.version }} from main to develop" \
--body "This PR back-merges the changes from the v${{ steps.get-version.outputs.version }} release into develop.

⚠️ **Merge conflicts were detected and need manual resolution.**

Please review and resolve any conflicts before merging." \
--base develop \
--head "$BACKMERGE_BRANCH" \
--repo ${{ github.repository }} || echo "PR creation failed, please create manually"
fi

# Step 12: Summary
- name: Release Summary
Expand All @@ -168,7 +233,7 @@ jobs:
echo "- **Version**: ${{ steps.get-version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
echo "- **npm Published**: ${{ steps.npm-publish.outputs.published }}" >> $GITHUB_STEP_SUMMARY
echo "- **GitHub Release**: ✅" >> $GITHUB_STEP_SUMMARY
echo "- **Back-merged to develop**: " >> $GITHUB_STEP_SUMMARY
echo "- **Back-merge Status**: Check workflow logs" >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY
echo "### 📋 Release Assets" >> $GITHUB_STEP_SUMMARY
echo '```' >> $GITHUB_STEP_SUMMARY
Expand Down
48 changes: 47 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,49 @@
# Changelog
## [1.0.4] - 2025-08-11

### Added
- **Queued Processes Domain** (2 tools + 1 resource): Monitor and manage asynchronous operations
- `lokalise_list_queued_processes` - List all queued processes with filtering
- `lokalise_get_queued_process` - Get detailed status of specific processes
- Resource: `lokalise-queued-processes` for process monitoring
- **Team Users Domain** (4 tools + 2 resources): Comprehensive team member management
- `lokalise_list_team_users` - List all team users with pagination
- `lokalise_get_team_user` - Get detailed user information
- `lokalise_update_team_user` - Update user role and permissions
- `lokalise_delete_team_user` - Remove users from team
- Resources: `lokalise-team-users` (collection) and `lokalise-team-user-details` (individual)
- **User Groups Domain** (9 tools + 2 resources): Advanced group-based permission management
- `lokalise_list_usergroups` - List all user groups in team
- `lokalise_get_usergroup` - Get group details with members and projects
- `lokalise_create_usergroup` - Create new permission groups
- `lokalise_update_usergroup` - Update group settings and permissions
- `lokalise_delete_usergroup` - Remove user groups
- `lokalise_add_members_to_group` - Add team members to groups
- `lokalise_remove_members_from_group` - Remove members from groups
- `lokalise_add_projects_to_group` - Assign projects to groups
- `lokalise_remove_projects_from_group` - Unassign projects from groups
- Resources: `lokalise-usergroups` (collection) and `lokalise-usergroup-details` (individual)
- **Enhanced MCP Prompts System**: Comprehensive workflow prompts for AI assistants
- Post-upload validation workflows for translation file imports
- Document extraction review workflows for content verification
- Expanded prompt schemas with detailed type definitions
- Structured workflow templates for common localization tasks

### Changed
- **MCP Prompts Architecture**: Complete restructure with detailed schemas and validation
- Added 700+ lines of type definitions for better type safety
- Expanded prompt templates from basic to comprehensive workflows
- Improved prompt organization with clear separation of concerns
- **Documentation Updates**: Enhanced README and CLAUDE.md with latest features

### Fixed
- Export ordering consistency across domain modules

### Developer Experience
- Total MCP tools increased from 39 to **54 tools** (+15)
- Total MCP resources increased from 16 to **21 resources** (+5)
- Enhanced auto-discovery system seamlessly integrates new domains
- Maintained 100% backward compatibility with existing integrations


All notable changes to this project will be documented in this file.

Expand Down Expand Up @@ -89,6 +134,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
- Commander.js for CLI framework
- ES modules with Node.js >=18.0.0 requirement

[1.0.4]: https://github.com/AbdallahAHO/lokalise-mcp/compare/v1.0.3...v1.0.4
[1.0.3]: https://github.com/AbdallahAHO/lokalise-mcp/compare/v1.0.2...v1.0.3
[1.0.2]: https://github.com/AbdallahAHO/lokalise-mcp/compare/v1.0.1...v1.0.2
[1.0.1]: https://github.com/AbdallahAHO/lokalise-mcp/compare/v1.0.0...v1.0.1
Expand Down
Loading