├── .github ├── FUNDING.yml ├── ISSUE_TEMPLATE │ ├── bug_report.md │ ├── documentation_template.md │ ├── feature_request.md │ ├── performance_template.md │ └── question_template.md └── PULL_REQUEST_TEMPLATE.md ├── .python-version ├── CODE_OF_CONDUCT.md ├── CONTRIBUTING.md ├── LICENSE ├── README.md ├── SECURITY.md ├── jadx_mcp_server.py ├── pyproject.toml ├── requirements.txt ├── static └── image.png └── uv.lock /.github/FUNDING.yml: -------------------------------------------------------------------------------- 1 | # These are supported funding model platforms 2 | 3 | github: zinja-coder 4 | ko_fi: zinjacoder 5 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/bug_report.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: Bug Report 3 | about: Report a bug or issue with the JADX-MCP-SERVER 4 | title: '[BUG] ' 5 | labels: bug 6 | assignees: '' 7 | --- 8 | 9 | ### Description 10 | A clear and concise description of the issue. 11 | 12 | ### Environment 13 | - JADX Version: [e.g. 1.4.7] 14 | - MCP Server Version: [e.g. 1.0.2] 15 | - OS: [e.g. Windows 11, macOS 14.4, Ubuntu 24.04] 16 | - Java Version: [e.g. OpenJDK 17.0.8] 17 | 18 | ### Steps to Reproduce 19 | 1. [First Step] 20 | 2. [Second Step] 21 | 3. [Additional steps...] 22 | 23 | ### Expected Behavior 24 | A clear and concise description of what you expected to happen. 25 | 26 | ### Actual Behavior 27 | A clear and concise description of what actually happened. 28 | 29 | ### Screenshots 30 | If applicable, add screenshots to help explain your problem. 31 | 32 | ### Sample Code/APK 33 | If possible, provide a minimal code sample or APK that reproduces the issue (make sure to remove any sensitive information). 34 | 35 | ### Logs 36 | Paste any relevant logs or error messages here 37 | 38 | ### Additional Context/ What you tried to solve it 39 | Add any other context about the problem here. -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/documentation_template.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: Documentation Issue 3 | about: Report issues with or suggest improvements to documentation 4 | title: '[DOCS] ' 5 | labels: documentation 6 | assignees: '' 7 | --- 8 | 9 | ### Documentation Issue 10 | Describe what's missing, unclear, or incorrect in the documentation. 11 | 12 | ### Location 13 | Provide a link or describe where the documentation issue is located. 14 | 15 | ### Suggested Improvement 16 | If you have suggestions for how to improve the documentation, describe them here. 17 | 18 | ### Additional Context 19 | Add any other context, references, or screenshots about the documentation issue here. -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/feature_request.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: Feature Request 3 | about: Suggest a new feature or enhancement for the JADX-MCP-SERVER 4 | title: '[FEATURE] ' 5 | labels: enhancement 6 | assignees: '' 7 | --- 8 | 9 | ### Feature Description 10 | A clear and concise description of the feature you're suggesting. 11 | 12 | ### Use Case 13 | Explain the use case or scenario where this feature would be valuable. How would you and others benefit from this feature? 14 | 15 | ### Proposed Solution 16 | If you have ideas about how to implement this feature, describe them here. Include any mockups, diagrams, or reference examples if applicable. 17 | 18 | ### Alternatives Considered 19 | Have you considered any alternative solutions or workarounds? If so, please describe them. 20 | 21 | ### Additional Context 22 | Add any other context, references, or screenshots about the feature request here. -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/performance_template.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: Performance Issue 3 | about: Report performance problems with the JADX-MCP-SERVER 4 | title: '[PERFORMANCE] ' 5 | labels: performance 6 | assignees: '' 7 | --- 8 | 9 | ### Performance Issue Description 10 | A clear and concise description of the performance issue you're experiencing. 11 | 12 | ### Environment 13 | - JADX Version: [e.g. 1.4.7] 14 | - Server Version: [e.g. 1.0.2] 15 | - OS: [e.g. Windows 11, macOS 14.4, Ubuntu 24.04] 16 | - Java Version: [e.g. OpenJDK 17.0.8] 17 | - System Specifications: [e.g. CPU, RAM, etc.] 18 | 19 | ### Steps to Reproduce 20 | 1. [First Step] 21 | 2. [Second Step] 22 | 3. [Additional steps...] 23 | 24 | ### Performance Measurements 25 | If possible, include specific metrics or measurements: 26 | - Execution time: [e.g. 30 seconds vs expected 5 seconds] 27 | - Memory usage: [e.g. 2GB RAM] 28 | - CPU usage: [e.g. 100% on all cores] 29 | 30 | ### Sample Code/APK 31 | If possible, provide a minimal code sample or APK that demonstrates the performance issue. 32 | 33 | ### Additional Context 34 | Add any other context about the performance issue here. -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/question_template.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: Question 3 | about: Ask a question about using or developing with the JADX-MCP-SERVER 4 | title: '[QUESTION] ' 5 | labels: question 6 | assignees: '' 7 | --- 8 | 9 | ### Question 10 | State your question clearly and provide as much context as possible. 11 | 12 | ### Environment (if relevant) 13 | - JADX Version: [e.g. 1.4.7] 14 | - Plugin Version: [e.g. 1.0.2] 15 | - OS: [e.g. Windows 11, macOS 14.4, Ubuntu 24.04] 16 | 17 | ### What I've Tried 18 | List any research or attempts you've made to find the answer before asking. 19 | 20 | ### Additional Information 21 | Any additional information or context that might help answer your question. -------------------------------------------------------------------------------- /.github/PULL_REQUEST_TEMPLATE.md: -------------------------------------------------------------------------------- 1 | # Pull Request 2 | 3 | ## Related Issues 4 | 5 | Closes # 6 | 7 | ## Summary of Changes 8 | 9 | 10 | - 11 | - 12 | - 13 | 14 | ## Testing 15 | 16 | 17 | - [ ] Ran all existing tests 18 | - [ ] Added new tests 19 | - [ ] Manually tested features 20 | 21 | ## Checklist 22 | - [ ] My code follows the project’s coding style. 23 | - [ ] I have added tests that prove my fix/feature works. 24 | - [ ] I have updated documentation where necessary. 25 | - [ ] My changes do not break existing functionality. 26 | - [ ] I have rebased on the latest `main` branch. 27 | 28 | ## Additional Notes 29 | 30 | -------------------------------------------------------------------------------- /.python-version: -------------------------------------------------------------------------------- 1 | 3.13 2 | -------------------------------------------------------------------------------- /CODE_OF_CONDUCT.md: -------------------------------------------------------------------------------- 1 | 2 | # Contributor Covenant Code of Conduct 3 | 4 | ## Our Pledge 5 | 6 | We as members, contributors, and leaders pledge to make participation in our 7 | community a harassment-free experience for everyone, regardless of age, body 8 | size, visible or invisible disability, ethnicity, sex characteristics, gender 9 | identity and expression, level of experience, education, socio-economic status, 10 | nationality, personal appearance, race, caste, color, religion, or sexual 11 | identity and orientation. 12 | 13 | We pledge to act and interact in ways that contribute to an open, welcoming, 14 | diverse, inclusive, and healthy community. 15 | 16 | ## Our Standards 17 | 18 | Examples of behavior that contributes to a positive environment for our 19 | community include: 20 | 21 | * Demonstrating empathy and kindness toward other people 22 | * Being respectful of differing opinions, viewpoints, and experiences 23 | * Giving and gracefully accepting constructive feedback 24 | * Accepting responsibility and apologizing to those affected by our mistakes, 25 | and learning from the experience 26 | * Focusing on what is best not just for us as individuals, but for the overall 27 | community 28 | 29 | Examples of unacceptable behavior include: 30 | 31 | * The use of sexualized language or imagery, and sexual attention or advances of 32 | any kind 33 | * Trolling, insulting or derogatory comments, and personal or political attacks 34 | * Public or private harassment 35 | * Publishing others' private information, such as a physical or email address, 36 | without their explicit permission 37 | * Other conduct which could reasonably be considered inappropriate in a 38 | professional setting 39 | 40 | ## Enforcement Responsibilities 41 | 42 | Community leaders are responsible for clarifying and enforcing our standards of 43 | acceptable behavior and will take appropriate and fair corrective action in 44 | response to any behavior that they deem inappropriate, threatening, offensive, 45 | or harmful. 46 | 47 | Community leaders have the right and responsibility to remove, edit, or reject 48 | comments, commits, code, wiki edits, issues, and other contributions that are 49 | not aligned to this Code of Conduct, and will communicate reasons for moderation 50 | decisions when appropriate. 51 | 52 | ## Scope 53 | 54 | This Code of Conduct applies within all community spaces, and also applies when 55 | an individual is officially representing the community in public spaces. 56 | Examples of representing our community include using an official email address, 57 | posting via an official social media account, or acting as an appointed 58 | representative at an online or offline event. 59 | 60 | ## Enforcement 61 | 62 | Instances of abusive, harassing, or otherwise unacceptable behavior may be 63 | reported to the community leaders responsible for enforcement at 64 | [INSERT CONTACT METHOD]. 65 | All complaints will be reviewed and investigated promptly and fairly. 66 | 67 | All community leaders are obligated to respect the privacy and security of the 68 | reporter of any incident. 69 | 70 | ## Enforcement Guidelines 71 | 72 | Community leaders will follow these Community Impact Guidelines in determining 73 | the consequences for any action they deem in violation of this Code of Conduct: 74 | 75 | ### 1. Correction 76 | 77 | **Community Impact**: Use of inappropriate language or other behavior deemed 78 | unprofessional or unwelcome in the community. 79 | 80 | **Consequence**: A private, written warning from community leaders, providing 81 | clarity around the nature of the violation and an explanation of why the 82 | behavior was inappropriate. A public apology may be requested. 83 | 84 | ### 2. Warning 85 | 86 | **Community Impact**: A violation through a single incident or series of 87 | actions. 88 | 89 | **Consequence**: A warning with consequences for continued behavior. No 90 | interaction with the people involved, including unsolicited interaction with 91 | those enforcing the Code of Conduct, for a specified period of time. This 92 | includes avoiding interactions in community spaces as well as external channels 93 | like social media. Violating these terms may lead to a temporary or permanent 94 | ban. 95 | 96 | ### 3. Temporary Ban 97 | 98 | **Community Impact**: A serious violation of community standards, including 99 | sustained inappropriate behavior. 100 | 101 | **Consequence**: A temporary ban from any sort of interaction or public 102 | communication with the community for a specified period of time. No public or 103 | private interaction with the people involved, including unsolicited interaction 104 | with those enforcing the Code of Conduct, is allowed during this period. 105 | Violating these terms may lead to a permanent ban. 106 | 107 | ### 4. Permanent Ban 108 | 109 | **Community Impact**: Demonstrating a pattern of violation of community 110 | standards, including sustained inappropriate behavior, harassment of an 111 | individual, or aggression toward or disparagement of classes of individuals. 112 | 113 | **Consequence**: A permanent ban from any sort of public interaction within the 114 | community. 115 | 116 | ## Attribution 117 | 118 | This Code of Conduct is adapted from the [Contributor Covenant][homepage], 119 | version 2.1, available at 120 | [https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1]. 121 | 122 | Community Impact Guidelines were inspired by 123 | [Mozilla's code of conduct enforcement ladder][Mozilla CoC]. 124 | 125 | For answers to common questions about this code of conduct, see the FAQ at 126 | [https://www.contributor-covenant.org/faq][FAQ]. Translations are available at 127 | [https://www.contributor-covenant.org/translations][translations]. 128 | 129 | [homepage]: https://www.contributor-covenant.org 130 | [v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html 131 | [Mozilla CoC]: https://github.com/mozilla/diversity 132 | [FAQ]: https://www.contributor-covenant.org/faq 133 | [translations]: https://www.contributor-covenant.org/translations 134 | 135 | -------------------------------------------------------------------------------- /CONTRIBUTING.md: -------------------------------------------------------------------------------- 1 | # Contributing to jadx-ai-mcp and jadx-mcp-server 2 | 3 | Thank you for considering contributing to the project! We welcome contributions that improve functionality, performance, documentation, or overall code quality. 4 | 5 | ## How to Contribute 6 | 7 | 1. **Fork the repository** 8 | - Click "Fork" at the top-right of the repository page. 9 | 10 | 2. **Clone your fork** 11 | ```bash 12 | git clone https://github.com/your-username/jadx-ai-mcp.git 13 | # or 14 | git clone https://github.com/your-username/jadx-mcp-server.git 15 | 16 | # Create a new branch 17 | git checkout -b your-feature-branch 18 | ``` 19 | 20 | 3. **Make your changes** 21 | 22 | - Follow the coding style used in the project. 23 | 24 | - Keep commits atomic and meaningful. 25 | 26 | - Add/update tests if necessary. 27 | 28 | - Update documentation if behavior changes. 29 | 30 | 4. **Test your changes** 31 | 32 | - Make sure everything builds and works properly. 33 | 34 | - Run existing tests and new ones you add. 35 | 36 | 5. **Submit a Pull Request** 37 | 38 | - Push your branch to your fork. 39 | 40 | - Open a pull request against the main branch. 41 | 42 | - Fill out the Pull Request Template. 43 | 44 | 6. **Code Style and Practices** 45 | 46 | - Write clear, concise commit messages. 47 | 48 | - Keep pull requests focused and small. 49 | 50 | - Document any new features or major changes. 51 | 52 | - Maintain backward compatibility where possible. 53 | 54 | ### Development Requirements 55 | 56 | - Java 11+ for jadx-ai-mcp 57 | 58 | - Python 3.10+ for jadx-mcp-server 59 | 60 | - Familiarity with MCP, jadx, and Android reverse engineering concepts is a plus. 61 | 62 | ### Communication 63 | 64 | If you plan to contribute a larger feature or change, please open an issue first to discuss it. 65 | 66 | **Thanks for helping make this project better! You are awesome and thanks in advance.** 67 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Apache License 2 | Version 2.0, January 2004 3 | http://www.apache.org/licenses/ 4 | 5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 6 | 7 | 1. Definitions. 8 | 9 | "License" shall mean the terms and conditions for use, reproduction, 10 | and distribution as defined by Sections 1 through 9 of this document. 11 | 12 | "Licensor" shall mean the copyright owner or entity authorized by 13 | the copyright owner that is granting the License. 14 | 15 | "Legal Entity" shall mean the union of the acting entity and all 16 | other entities that control, are controlled by, or are under common 17 | control with that entity. For the purposes of this definition, 18 | "control" means (i) the power, direct or indirect, to cause the 19 | direction or management of such entity, whether by contract or 20 | otherwise, or (ii) ownership of fifty percent (50%) or more of the 21 | outstanding shares, or (iii) beneficial ownership of such entity. 22 | 23 | "You" (or "Your") shall mean an individual or Legal Entity 24 | exercising permissions granted by this License. 25 | 26 | "Source" form shall mean the preferred form for making modifications, 27 | including but not limited to software source code, documentation 28 | source, and configuration files. 29 | 30 | "Object" form shall mean any form resulting from mechanical 31 | transformation or translation of a Source form, including but 32 | not limited to compiled object code, generated documentation, 33 | and conversions to other media types. 34 | 35 | "Work" shall mean the work of authorship, whether in Source or 36 | Object form, made available under the License, as indicated by a 37 | copyright notice that is included in or attached to the work 38 | (an example is provided in the Appendix below). 39 | 40 | "Derivative Works" shall mean any work, whether in Source or Object 41 | form, that is based on (or derived from) the Work and for which the 42 | editorial revisions, annotations, elaborations, or other modifications 43 | represent, as a whole, an original work of authorship. For the purposes 44 | of this License, Derivative Works shall not include works that remain 45 | separable from, or merely link (or bind by name) to the interfaces of, 46 | the Work and Derivative Works thereof. 47 | 48 | "Contribution" shall mean any work of authorship, including 49 | the original version of the Work and any modifications or additions 50 | to that Work or Derivative Works thereof, that is intentionally 51 | submitted to Licensor for inclusion in the Work by the copyright owner 52 | or by an individual or Legal Entity authorized to submit on behalf of 53 | the copyright owner. For the purposes of this definition, "submitted" 54 | means any form of electronic, verbal, or written communication sent 55 | to the Licensor or its representatives, including but not limited to 56 | communication on electronic mailing lists, source code control systems, 57 | and issue tracking systems that are managed by, or on behalf of, the 58 | Licensor for the purpose of discussing and improving the Work, but 59 | excluding communication that is conspicuously marked or otherwise 60 | designated in writing by the copyright owner as "Not a Contribution." 61 | 62 | "Contributor" shall mean Licensor and any individual or Legal Entity 63 | on behalf of whom a Contribution has been received by Licensor and 64 | subsequently incorporated within the Work. 65 | 66 | 2. Grant of Copyright License. Subject to the terms and conditions of 67 | this License, each Contributor hereby grants to You a perpetual, 68 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 69 | copyright license to reproduce, prepare Derivative Works of, 70 | publicly display, publicly perform, sublicense, and distribute the 71 | Work and such Derivative Works in Source or Object form. 72 | 73 | 3. Grant of Patent License. Subject to the terms and conditions of 74 | this License, each Contributor hereby grants to You a perpetual, 75 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 76 | (except as stated in this section) patent license to make, have made, 77 | use, offer to sell, sell, import, and otherwise transfer the Work, 78 | where such license applies only to those patent claims licensable 79 | by such Contributor that are necessarily infringed by their 80 | Contribution(s) alone or by combination of their Contribution(s) 81 | with the Work to which such Contribution(s) was submitted. If You 82 | institute patent litigation against any entity (including a 83 | cross-claim or counterclaim in a lawsuit) alleging that the Work 84 | or a Contribution incorporated within the Work constitutes direct 85 | or contributory patent infringement, then any patent licenses 86 | granted to You under this License for that Work shall terminate 87 | as of the date such litigation is filed. 88 | 89 | 4. Redistribution. You may reproduce and distribute copies of the 90 | Work or Derivative Works thereof in any medium, with or without 91 | modifications, and in Source or Object form, provided that You 92 | meet the following conditions: 93 | 94 | (a) You must give any other recipients of the Work or 95 | Derivative Works a copy of this License; and 96 | 97 | (b) You must cause any modified files to carry prominent notices 98 | stating that You changed the files; and 99 | 100 | (c) You must retain, in the Source form of any Derivative Works 101 | that You distribute, all copyright, patent, trademark, and 102 | attribution notices from the Source form of the Work, 103 | excluding those notices that do not pertain to any part of 104 | the Derivative Works; and 105 | 106 | (d) If the Work includes a "NOTICE" text file as part of its 107 | distribution, then any Derivative Works that You distribute must 108 | include a readable copy of the attribution notices contained 109 | within such NOTICE file, excluding those notices that do not 110 | pertain to any part of the Derivative Works, in at least one 111 | of the following places: within a NOTICE text file distributed 112 | as part of the Derivative Works; within the Source form or 113 | documentation, if provided along with the Derivative Works; or, 114 | within a display generated by the Derivative Works, if and 115 | wherever such third-party notices normally appear. The contents 116 | of the NOTICE file are for informational purposes only and 117 | do not modify the License. You may add Your own attribution 118 | notices within Derivative Works that You distribute, alongside 119 | or as an addendum to the NOTICE text from the Work, provided 120 | that such additional attribution notices cannot be construed 121 | as modifying the License. 122 | 123 | You may add Your own copyright statement to Your modifications and 124 | may provide additional or different license terms and conditions 125 | for use, reproduction, or distribution of Your modifications, or 126 | for any such Derivative Works as a whole, provided Your use, 127 | reproduction, and distribution of the Work otherwise complies with 128 | the conditions stated in this License. 129 | 130 | 5. Submission of Contributions. Unless You explicitly state otherwise, 131 | any Contribution intentionally submitted for inclusion in the Work 132 | by You to the Licensor shall be under the terms and conditions of 133 | this License, without any additional terms or conditions. 134 | Notwithstanding the above, nothing herein shall supersede or modify 135 | the terms of any separate license agreement you may have executed 136 | with Licensor regarding such Contributions. 137 | 138 | 6. Trademarks. This License does not grant permission to use the trade 139 | names, trademarks, service marks, or product names of the Licensor, 140 | except as required for reasonable and customary use in describing the 141 | origin of the Work and reproducing the content of the NOTICE file. 142 | 143 | 7. Disclaimer of Warranty. Unless required by applicable law or 144 | agreed to in writing, Licensor provides the Work (and each 145 | Contributor provides its Contributions) on an "AS IS" BASIS, 146 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 147 | implied, including, without limitation, any warranties or conditions 148 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A 149 | PARTICULAR PURPOSE. You are solely responsible for determining the 150 | appropriateness of using or redistributing the Work and assume any 151 | risks associated with Your exercise of permissions under this License. 152 | 153 | 8. Limitation of Liability. In no event and under no legal theory, 154 | whether in tort (including negligence), contract, or otherwise, 155 | unless required by applicable law (such as deliberate and grossly 156 | negligent acts) or agreed to in writing, shall any Contributor be 157 | liable to You for damages, including any direct, indirect, special, 158 | incidental, or consequential damages of any character arising as a 159 | result of this License or out of the use or inability to use the 160 | Work (including but not limited to damages for loss of goodwill, 161 | work stoppage, computer failure or malfunction, or any and all 162 | other commercial damages or losses), even if such Contributor 163 | has been advised of the possibility of such damages. 164 | 165 | 9. Accepting Warranty or Additional Liability. While redistributing 166 | the Work or Derivative Works thereof, You may choose to offer, 167 | and charge a fee for, acceptance of support, warranty, indemnity, 168 | or other liability obligations and/or rights consistent with this 169 | License. However, in accepting such obligations, You may act only 170 | on Your own behalf and on Your sole responsibility, not on behalf 171 | of any other Contributor, and only if You agree to indemnify, 172 | defend, and hold each Contributor harmless for any liability 173 | incurred by, or claims asserted against, such Contributor by reason 174 | of your accepting any such warranty or additional liability. 175 | 176 | END OF TERMS AND CONDITIONS 177 | 178 | APPENDIX: How to apply the Apache License to your work. 179 | 180 | To apply the Apache License to your work, attach the following 181 | boilerplate notice, with the fields enclosed by brackets "[]" 182 | replaced with your own identifying information. (Don't include 183 | the brackets!) The text should be enclosed in the appropriate 184 | comment syntax for the file format. We also recommend that a 185 | file or class name and description of purpose be included on the 186 | same "printed page" as the copyright notice for easier 187 | identification within third-party archives. 188 | 189 | Copyright [yyyy] [name of copyright owner] 190 | 191 | Licensed under the Apache License, Version 2.0 (the "License"); 192 | you may not use this file except in compliance with the License. 193 | You may obtain a copy of the License at 194 | 195 | http://www.apache.org/licenses/LICENSE-2.0 196 | 197 | Unless required by applicable law or agreed to in writing, software 198 | distributed under the License is distributed on an "AS IS" BASIS, 199 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 200 | See the License for the specific language governing permissions and 201 | limitations under the License. 202 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 |
2 | 3 | # JADX-MCP-SERVER (Part of Zin's Reverse Engineering MCP Suite) 4 | 5 | ⚡ Fully automated MCP server built to communicate with JADX-AI-MCP Plugin to analyze Android APKs using LLMs like Claude — uncover vulnerabilities, parse manifests, and reverse engineer effortlessly. 6 | 7 | ![GitHub contributors JADX-AI-MCP](https://img.shields.io/github/contributors/zinja-coder/jadx-ai-mcp) 8 | ![GitHub contributors JADX-MCP-SERVER](https://img.shields.io/github/contributors/zinja-coder/jadx-mcp-server) 9 | ![GitHub all releases](https://img.shields.io/github/downloads/zinja-coder/jadx-ai-mcp/total) 10 | ![GitHub release (latest by SemVer)](https://img.shields.io/github/downloads/zinja-coder/jadx-ai-mcp/latest/total) 11 | ![Latest release](https://img.shields.io/github/release/zinja-coder/jadx-ai-mcp.svg) 12 | ![Java 11+](https://img.shields.io/badge/Java-11%2B-blue) 13 | ![Python 3.10+](https://img.shields.io/badge/python-3%2E10%2B-blue) 14 | [![License](http://img.shields.io/:license-apache-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0.html) 15 | 16 |
17 | 18 | 19 | 20 | 21 | 22 |
23 | banner 24 |
25 | 26 | 27 | 28 | --- 29 | 30 | #### Download now: https://github.com/zinja-coder/jadx-ai-mcp/releases 31 | 32 | --- 33 | 34 | ## 🤖 What is JADX-MCP-SERVER? 35 | 36 | **JADX MCP Server** is a standalone Python server that interacts with a modified version of `jadx-gui` (see: [jadx-ai-mcp](https://github.com/zinja-coder/jadx-ai-mcp)) via MCP (Model Context Protocol). It lets LLMs communicate with the decompiled Android app context live. 37 | 38 | 39 | ## 🤖 What is JADX-AI-MCP? 40 | 41 | **JADX-AI-MCP** is a plugin for the [JADX decompiler](https://github.com/skylot/jadx) that integrates directly with [Model Context Protocol (MCP)](https://github.com/anthropic/mcp) to provide **live reverse engineering support with LLMs like Claude**. 42 | 43 | Think: "Decompile → Context-Aware Code Review → AI Recommendations" — all in real time. 44 | 45 | Watch the demos! 46 | 47 | - **Perform quick analysis** 48 | 49 | https://github.com/user-attachments/assets/b65c3041-fde3-4803-8d99-45ca77dbe30a 50 | 51 | - **Quickly find vulnerabilities** 52 | 53 | https://github.com/user-attachments/assets/c184afae-3713-4bc0-a1d0-546c1f4eb57f 54 | 55 | - **Multiple AI Agents Support** 56 | 57 | https://github.com/user-attachments/assets/6342ea0f-fa8f-44e6-9b3a-4ceb8919a5b0 58 | 59 | - **Analyze The APK Resources** 60 | 61 | https://github.com/user-attachments/assets/f42d8072-0e3e-4f03-93ea-121af4e66eb1 62 | 63 | It is combination of two tools: 64 | 1. [JADX-AI-MCP](https://github.com/zinja-coder/jadx-ai-mcp) 65 | 2. JADX MCP SERVER 66 | 67 | --- 68 | 69 | # Zin MCP Suie 70 | - **[APKTool-MCP-Server](https://github.com/zinja-coder/apktool-mcp-server)** 71 | - **[JAD-AI-MCP-Plugin](https://github.com/zinja-coder/jadx-ai-mcp)** 72 | - **[ZIN-MCP-Client](https://github.com/zinja-coder/zin-mcp-client)** 73 | 74 | ## Current MCP Tools 75 | 76 | The following MCP tools are available: 77 | 78 | - `fetch_current_class()` — Get the class name and full source of selected class 79 | - `get_selected_text()` — Get currently selected text 80 | - `get_all_classes()` — List all classes in the project 81 | - `get_class_source()` — Get full source of a given class 82 | - `get_method_by_name()` — Fetch a method’s source 83 | - `search_method_by_name()` — Search method across classes 84 | - `get_methods_of_class()` — List methods in a class 85 | - `get_fields_of_class()` — List fields in a class 86 | - `get_smali_of_class()` — Fetch smali of class 87 | - `get_main_activity_class()` — Fetch main activity from jadx mentioned in AndroidManifest.xml file. 88 | - `get_main_application_classes_code()` — Fetch all the main application classes' code based on the package name defined in the AndroidManifest.xml. 89 | - `get_main_application_classes_names()` — Fetch all the main application classes' names based on the package name defined in the AndroidManifest.xml. 90 | - `get_android_manifest()` — Retrieve and return the AndroidManifest.xml content. 91 | - `get_strings()` : Fetches the strings.xml file 92 | - `get_all_resource_file_names()` : Retrieve all resource files names that exists in application 93 | - `get_resource_file()` : Retrieve resource file content 94 | 95 | --- 96 | 97 | #### Note: Tested on Claude Desktop. Support for other LLMs might be tested in future. 98 | 99 | ## 🗒️ Sample Prompts 100 | 101 | 🔍 Basic Code Understanding 102 | 103 | "Explain what this class does in one paragraph." 104 | 105 | "Summarize the responsibilities of this method." 106 | 107 | "Is there any obfuscation in this class?" 108 | 109 | "List all Android permissions this class might require." 110 | 111 | 🛡️ Vulnerability Detection 112 | 113 | "Are there any insecure API usages in this method?" 114 | 115 | "Check this class for hardcoded secrets or credentials." 116 | 117 | "Does this method sanitize user input before using it?" 118 | 119 | "What security vulnerabilities might be introduced by this code?" 120 | 121 | 🛠️ Reverse Engineering Helpers 122 | 123 | "Deobfuscate and rename the classes and methods to something readable." 124 | 125 | "Can you infer the original purpose of this smali method?" 126 | 127 | "What libraries or SDKs does this class appear to be part of?" 128 | 129 | 📦 Static Analysis 130 | 131 | "List all network-related API calls in this class." 132 | 133 | "Identify file I/O operations and their potential risks." 134 | 135 | "Does this method leak device info or PII?" 136 | 137 | 🤖 AI Code Modification 138 | 139 | "Refactor this method to improve readability." 140 | 141 | "Add comments to this code explaining each step." 142 | 143 | "Rewrite this Java method in Python for analysis." 144 | 145 | 📄 Documentation & Metadata 146 | 147 | "Generate Javadoc-style comments for all methods." 148 | 149 | "What package or app component does this class likely belong to?" 150 | 151 | "Can you identify the Android component type (Activity, Service, etc.)?" 152 | --- 153 | 154 | ## 🛠️ Getting Started 155 | 156 | [READ HERE](https://github.com/zinja-coder/jadx-ai-mcp?tab=readme-ov-file#%EF%B8%8F-getting-started) 157 | 158 | ## Running on Local LLM Using Ollama and Zin MCP Client - Recommended 159 | 160 |
161 | 162 | zin-mcp-client 163 | 164 |
165 | 166 | ⚡ Lightweight, Fast, Simple, CLI-Based MCP Client for STDIO MCP Servers, to fill the gap and provide bridge between your local LLMs running Ollama and MCP Servers. 167 | 168 | Check Now: https://github.com/zinja-coder/zin-mcp-client 169 | 170 | Demo: **Perform Code Review to Find Vulnerabilities locally** 171 | 172 | https://github.com/user-attachments/assets/4cd26715-b5e6-4b4b-95e4-054de6789f42 173 | 174 | ## 🛣️ Future Roadmap 175 | 176 | - [x] Add Support for apktool 177 | 178 | - [ ] Add support for hermes code (ReactNative Application) 179 | 180 | - [ ] Add more useful MCP Tools 181 | 182 | - [ ] Make LLM be able to modify code on JADX 183 | 184 | - [ ] Add prompts templates, give llm access to Android APK Files as Resources 185 | 186 | - [ ] Build MCP Client to support Local LLM 187 | 188 | - [ ] **END-GOAL** : Make all android reverse engineering and APK modification tools Connect with single MCP server to make reverse engineering apk files as easy as possible purely from vibes. 189 | 190 | ## NOTE For Contributors 191 | 192 | - The files related to JADX-AI-MCP can be found [here](https://github.com/zinja-coder/jadx-ai-mcp) 193 | 194 | - The files related to **jadx-mcp-server** can be found in this repository only. 195 | 196 | ## 🙏 Credits 197 | 198 | This project is a plugin for JADX, an amazing open-source Android decompiler created and maintained by [@skylot](https://github.com/skylot). All core decompilation logic belongs to them. I have only extended it to support my MCP server with AI capabilities. 199 | 200 | [📎 Original README (JADX)](https://github.com/skylot/jadx) 201 | 202 | The original README.md from jadx is included here in this repository for reference and credit. 203 | 204 | This MCP server is made possible by the extensibility of JADX-GUI and the amazing Android reverse engineering community. 205 | 206 | Also huge thanks to [@aaddrick](https://github.com/aaddrick) for developing Claude desktop for Debian based linux. 207 | 208 | And in last thanks to [@anthropics](https://github.com/anthropics) for developing the Model Context Protocol and [@FastMCP](https://github.com/modelcontextprotocol/python-sdk) team 209 | 210 | And all opensource maintainers and contributors that makes libraries and dependencies which allows project like this possible. 211 | 212 | ## Audited and Received Assessment Badge 213 | 214 | [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/zinja-coder-jadx-mcp-server-badge.png)](https://mseep.ai/app/zinja-coder-jadx-mcp-server) 215 | 216 | Thank you Mseep.net for auditing and providing Assessment Badge. 217 | 218 | ## 📄 License 219 | 220 | This plugin inherits the Apache 2.0 License from the original JADX repository. 221 | 222 | ## ⚖️ Legal Warning 223 | 224 | **Disclaimer** 225 | 226 | The tools `jadx-ai-mcp` and `jadx_mcp_server` are intended strictly for educational, research, and ethical security assessment purposes. They are provided "as-is" without any warranties, expressed or implied. Users are solely responsible for ensuring that their use of these tools complies with all applicable laws, regulations, and ethical guidelines. 227 | 228 | By using `jadx-ai-mcp` or `jadx_mcp_server`, you agree to use them only in environments you are authorized to test, such as applications you own or have explicit permission to analyze. Any misuse of these tools for unauthorized reverse engineering, infringement of intellectual property rights, or malicious activity is strictly prohibited. 229 | 230 | The developers of `jadx-ai-mcp` and `jadx_mcp_server` shall not be held liable for any damage, data loss, legal consequences, or other consequences resulting from the use or misuse of these tools. Users assume full responsibility for their actions and any impact caused by their usage. 231 | 232 | Use responsibly. Respect intellectual property. Follow ethical hacking practices. 233 | 234 | --- 235 | 236 | ## 🙌 Contribute or Support 237 | 238 | - Found it useful? Give it a ⭐️ 239 | - Got ideas? Open an [issue](https://github.com/zinja-coder/jadx-mcp-server/issues) or submit a PR 240 | - Built something on top? DM me or mention me — I’ll add it to the README! 241 | 242 | --- 243 | 244 | Built with ❤️ for the reverse engineering and AI communities. 245 | -------------------------------------------------------------------------------- /SECURITY.md: -------------------------------------------------------------------------------- 1 | # Security Policy 2 | --- 3 | ### Reporting a Vulnerability 4 | 5 | To report a security issue, please open a new [security advisory](https://github.com/zinja-coder/jadx-mcp-server/security/advisories). Please fill the steps you took to create the issue, affected versions, and, if known, mitigations for the issue. We will check and respond within 3 working days. If the issue is confirmed as a vulnerability, we will apply required mitigations at the next release. 6 | -------------------------------------------------------------------------------- /jadx_mcp_server.py: -------------------------------------------------------------------------------- 1 | # /// script 2 | # requires-python = ">=3.10" 3 | # dependencies = [ "fastmcp", "httpx", "logging" ] 4 | # /// 5 | 6 | """ 7 | Copyright (c) 2025 jadx mcp server developer(s) (https://github.com/zinja-coder/jadx-ai-mcp) 8 | See the file 'LICENSE' for copying permission 9 | """ 10 | 11 | import httpx 12 | import logging 13 | import time 14 | import random 15 | 16 | from typing import List, Union, Dict, Optional 17 | from mcp.server.fastmcp import FastMCP 18 | 19 | # Cache configuration 20 | CACHE_EXPIRY = 300 # 5 minutes in seconds 21 | _cache: Dict[str, tuple[float, List[str]]] = {} # {key: (timestamp, data)} 22 | 23 | def _get_from_cache(key: str) -> Optional[List[str]]: 24 | """Get data from cache if it exists and is not expired.""" 25 | current_time = time.time() 26 | 27 | # Check if key exists and is not expired 28 | if key in _cache: 29 | timestamp, data = _cache[key] 30 | if current_time - timestamp < CACHE_EXPIRY: 31 | return data 32 | # Remove expired item 33 | del _cache[key] 34 | 35 | # Periodically clean up other expired items (e.g., every 10 accesses) 36 | # This helps prevent memory issues from accumulating expired entries 37 | if random.random() < 0.1: # ~10% chance to clean up 38 | expired_keys = [k for k, (ts, _) in _cache.items() 39 | if current_time - ts >= CACHE_EXPIRY] 40 | for k in expired_keys: 41 | del _cache[k] 42 | 43 | return None 44 | 45 | def _set_cache(key: str, data: List[str]) -> None: 46 | """Store data in cache with current timestamp.""" 47 | _cache[key] = (time.time(), data) 48 | 49 | def _clear_cache() -> None: 50 | """Clear all cached data.""" 51 | _cache.clear() 52 | 53 | 54 | # Set up logging configuration 55 | logger = logging.getLogger() 56 | logger.setLevel(logging.ERROR) 57 | 58 | # Console handler for logging to the console 59 | console_handler = logging.StreamHandler() 60 | console_handler.setLevel(logging.ERROR) 61 | console_handler.setFormatter(logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')) 62 | logger.addHandler(console_handler) 63 | 64 | # Initialize the MCP server 65 | mcp = FastMCP("JADX-AI-MCP Plugin Reverse Engineering Server") 66 | 67 | # To do : implement logic to handle the scenario where port is not available 68 | JADX_HTTP_BASE = "http://127.0.0.1:8650" # Base URL for the JADX-AI-MCP Plugin 69 | 70 | 71 | # Generic method to fetch data from jadx 72 | async def get_from_jadx(endpoint: str, params: dict = {}) -> Union[str, dict]: 73 | """Generic helper to request data from the JADX plugin with proper error reporting and logging.""" 74 | try: 75 | async with httpx.AsyncClient() as client: 76 | resp = await client.get(f"{JADX_HTTP_BASE}/{endpoint}", params=params, timeout=60) 77 | resp.raise_for_status() 78 | return resp.text 79 | except httpx.HTTPStatusError as e: 80 | error_message = f"HTTP error {e.response.status_code}: {e.response.text}" 81 | logger.error(error_message) 82 | return {"error": f"{error_message}."} 83 | except httpx.RequestError as e: 84 | error_message = f"Request failed: {str(e)}" 85 | logger.error(error_message) 86 | return {"error": f"{error_message}."} 87 | except Exception as e: 88 | error_message = f"Unexpected error: {str(e)}" 89 | logger.error(error_message) 90 | return {"error": f"{error_message}."} 91 | 92 | # Specific MCP tools 93 | 94 | @mcp.tool(name="fetch_current_class", description="Fetch the currently selected class and its code from the JADX-GUI plugin.") 95 | async def fetch_current_class() -> dict: 96 | """Fetch currently opened class in jadx. 97 | 98 | Args: 99 | None 100 | 101 | Returns: 102 | Dictionary containing currently opened class in jadx. 103 | """ 104 | return await get_from_jadx("current-class") 105 | 106 | @mcp.tool(name="get_selected_text", description="Returns the currently selected text in the decompiled code view.") 107 | async def get_selected_text() -> str: 108 | """Returns the currently selected text in the decompiled code view. 109 | 110 | Args: 111 | None 112 | 113 | Returns: 114 | String containing currently highlighted/selected text in jadx-gui. 115 | """ 116 | return await get_from_jadx("selected-text") 117 | 118 | @mcp.tool(name="get_method_by_name", description="Fetch the source code of a method from a specific class.") 119 | async def get_method_by_name(class_name: str, method_name: str) -> dict: 120 | """Fetch the source code of a method from a specific class. 121 | 122 | Args: 123 | class_name: Name of the class whose method's code will be returned 124 | method_name: Name of the method whose code will be returned 125 | 126 | Returns: 127 | Code of requested method as String. 128 | """ 129 | return await get_from_jadx("method-by-name", {"class": class_name, "method": method_name}) 130 | 131 | @mcp.tool(name="get_all_classes", description="Returns a list of all classes in the project.") 132 | async def get_all_classes(offset: int = 0, count: int = 0) -> List[str]: 133 | """Returns a list of all classes in the project. 134 | 135 | Args: 136 | offset: Offset to start listing from (start at 0) 137 | count: Number of strings to list (0 means remainder) 138 | 139 | Returns: 140 | A list of all classes in the project. 141 | """ 142 | # Validate offset and count are non-negative 143 | offset = max(0, offset) 144 | count = max(0, count) 145 | 146 | cache_key = "all_classes" 147 | all_classes = _get_from_cache(cache_key) 148 | 149 | if all_classes is None: 150 | response = await get_from_jadx(f"all-classes") 151 | if isinstance(response, dict): 152 | all_classes = response.get("classes", []) 153 | else: 154 | import json 155 | try: 156 | parsed = json.loads(response) 157 | all_classes = parsed.get("classes", []) 158 | except (json.JSONDecodeError, AttributeError): 159 | all_classes = [] 160 | _set_cache(cache_key, all_classes) 161 | 162 | if offset >= len(all_classes): 163 | return [] 164 | 165 | if count > 0: 166 | return all_classes[offset:offset + count] 167 | return all_classes[offset:] 168 | 169 | @mcp.tool(name="", description="") 170 | async def get_class_source(class_name: str) -> str: 171 | """Fetch the Java source of a specific class. 172 | 173 | Args: 174 | class_name: Name of the class whose source code will be returned 175 | 176 | Returns: 177 | Code of requested class as String. 178 | """ 179 | return await get_from_jadx("class-source", {"class": class_name}) 180 | 181 | @mcp.tool(name="search_method_by_name", description="Search for a method name across all classes.") 182 | async def search_method_by_name(method_name: str, offset: int = 0, count: int = 0) -> List[str]: 183 | """Search for a method name across all classes. 184 | 185 | Args: 186 | method_name: The name of the method to search for 187 | offset: Offset to start listing from (start at 0) 188 | count: Number of strings to list (0 means remainder) 189 | 190 | Returns: 191 | A list of all classes containing the method. 192 | """ 193 | # Validate offset and count are non-negative 194 | offset = max(0, offset) 195 | count = max(0, count) 196 | 197 | cache_key = f"search_method_{method_name}" 198 | all_matches = _get_from_cache(cache_key) 199 | 200 | if all_matches is None: 201 | response = await get_from_jadx("search-method", {"method": method_name}) 202 | all_matches = response.splitlines() if response else [] 203 | _set_cache(cache_key, all_matches) 204 | 205 | if offset >= len(all_matches): 206 | return [] 207 | 208 | if count > 0: 209 | return all_matches[offset:offset + count] 210 | return all_matches[offset:] 211 | 212 | @mcp.tool(name="get_methods_of_class", description="List all method names in a class.") 213 | async def get_methods_of_class(class_name: str, offset: int = 0, count: int = 0) -> List[str]: 214 | """List all method names in a class. 215 | 216 | Args: 217 | class_name: The name of the class to search for 218 | offset: Offset to start listing from (start at 0) 219 | count: Number of strings to list (0 means remainder) 220 | 221 | Returns: 222 | A list of all methods in the class. 223 | """ 224 | # Validate offset and count are non-negative 225 | offset = max(0, offset) 226 | count = max(0, count) 227 | 228 | cache_key = f"methods_of_class_{class_name}" 229 | all_methods = _get_from_cache(cache_key) 230 | 231 | if all_methods is None: 232 | response = await get_from_jadx("methods-of-class", {"class": class_name}) 233 | all_methods = response.splitlines() if response else [] 234 | _set_cache(cache_key, all_methods) 235 | 236 | if offset >= len(all_methods): 237 | return [] 238 | 239 | if count > 0: 240 | return all_methods[offset:offset + count] 241 | return all_methods[offset:] 242 | 243 | @mcp.tool(name="get_fields_of_class", description="List all field names in a class.") 244 | async def get_fields_of_class(class_name: str, offset: int = 0, count: int = 0) -> List[str]: 245 | """List all field names in a class. 246 | 247 | Args: 248 | class_name: The name of the class to search for 249 | offset: Offset to start listing from (start at 0) 250 | count: Number of strings to list (0 means remainder) 251 | 252 | Returns: 253 | A list of all fields in the class. 254 | """ 255 | # Validate offset and count are non-negative 256 | offset = max(0, offset) 257 | count = max(0, count) 258 | 259 | cache_key = f"fields_of_class_{class_name}" 260 | all_fields = _get_from_cache(cache_key) 261 | 262 | if all_fields is None: 263 | response = await get_from_jadx("fields-of-class", {"class": class_name}) 264 | all_fields = response.splitlines() if response else [] 265 | _set_cache(cache_key, all_fields) 266 | 267 | if offset >= len(all_fields): 268 | return [] 269 | 270 | if count > 0: 271 | return all_fields[offset:offset + count] 272 | return all_fields[offset:] 273 | 274 | @mcp.tool(name="get_smali_of_class", description="Fetch the smali representation of a class.") 275 | async def get_smali_of_class(class_name: str) -> str: 276 | """Fetch the smali representation of a class. 277 | 278 | Args: 279 | class_name: Name of the class whose smali is to be returned 280 | 281 | Returns: 282 | Smali code of the requested class as String. 283 | """ 284 | return await get_from_jadx("smali-of-class", {"class": class_name}) 285 | 286 | @mcp.tool(name="get_android_manifest", description="Retrieve and return the AndroidManifest.xml content.") 287 | async def get_android_manifest() -> dict: 288 | """Retrieve and return the AndroidManifest.xml content. 289 | 290 | Args: 291 | None 292 | 293 | Returns: 294 | Dictionary containing content of AndroidManifest.xml file. 295 | """ 296 | return await get_from_jadx("manifest") 297 | 298 | @mcp.tool(name="get_strings", description="Retrieve contents of strings.xml files that exists in application.") 299 | async def get_strings() -> dict: 300 | """Retrieve contents of strings.xml files that exists in application 301 | 302 | Args: 303 | None 304 | 305 | Returns: 306 | Dictionary containing contents of strings.xml file. 307 | """ 308 | return await get_from_jadx("strings") 309 | 310 | @mcp.tool(name="get_all_resource_file_names", description="Retrieve all resource files names that exists in application.") 311 | async def get_all_resource_file_names() -> list[str]: 312 | """Retrieve all resource files names that exists in application 313 | 314 | Args: 315 | None 316 | 317 | Returns: 318 | List of all resource files names. 319 | """ 320 | return await get_from_jadx("list-all-resource-files-names") 321 | 322 | @mcp.tool(name="get_resource_file", description="Retrieve resource file content.") 323 | async def get_resource_file(resource_name: str) -> list[str]: 324 | """Retrieve resource file content 325 | 326 | Args: 327 | resource_name: Name of the resource file 328 | 329 | Returns: 330 | Gets the content of resource file specified in 'resource_name' parameter 331 | """ 332 | return await get_from_jadx("get-resource-file", {"name": resource_name}) 333 | 334 | @mcp.tool(name="get_main_application_classes_names", description="Fetch all the main application classes' names based on the package name defined in the AndroidManifest.xml.") 335 | async def get_main_application_classes_names(offset: int = 0, count: int = 0) -> List[str]: 336 | """Fetch all the main application classes' names based on the package name defined in the AndroidManifest.xml. 337 | 338 | Args: 339 | offset: Offset to start listing from (start at 0) 340 | count: Number of strings to list (0 means remainder) 341 | 342 | Returns: 343 | Dictionary containing all the main application's classes' names based on the package name defined in the AndroidManifest.xml file. 344 | """ 345 | 346 | offset = max(0, offset) 347 | count = max(0, count) 348 | 349 | cache_key = "main_application_classes_names" 350 | class_names = _get_from_cache(cache_key) 351 | 352 | if class_names is None: 353 | response = await get_from_jadx("main-application-classes-names") 354 | if isinstance(response, dict): 355 | class_names = response.get("classes", []) 356 | else: 357 | import json 358 | try: 359 | parsed = json.loads(response) 360 | class_info_list = parsed.get("classes", []) 361 | class_names = [cls_info.get("name") for cls_info in class_info_list if "name" in cls_info] 362 | except (json.JSONDecodeError, AttributeError): 363 | class_names = [] 364 | _set_cache(cache_key, class_names) 365 | 366 | if offset >= len(class_names): 367 | return [] 368 | 369 | return class_names[offset:offset + count] if count > 0 else class_names[offset:] 370 | 371 | @mcp.tool(name="get_main_application_classes_code", description="Fetch all the main application classes' code based on the package name defined in the AndroidManifest.xml.") 372 | async def get_main_application_classes_code(offset: int = 0, count: int = 0) -> List[dict]: 373 | """Fetch all the main application classes' code based on the package name defined in the AndroidManifest.xml. 374 | 375 | Args: 376 | offset: Offset to start listing from (start at 0) 377 | count: Number of strings to list (0 means remainder) 378 | 379 | Returns: 380 | Dictionary containing all classes' source code which are under main package only based on package name defined in the AndroidManifest.xml file. 381 | """ 382 | 383 | offset = max(0, offset) 384 | count = max(0, count) 385 | 386 | cache_key = "main_application_classes_code" 387 | class_sources = _get_from_cache(cache_key) 388 | 389 | if class_sources is None: 390 | response = await get_from_jadx("main-application-classes-code") 391 | import json 392 | try: 393 | parsed = json.loads(response) 394 | class_sources = parsed.get("allClassesInPackage", []) 395 | except (json.JSONDecodeError, AttributeError): 396 | class_sources = [] 397 | _set_cache(cache_key, class_sources) 398 | 399 | if offset >= len(class_sources): 400 | return [] 401 | 402 | return class_sources[offset:offset + count] if count > 0 else class_sources[offset:] 403 | 404 | @mcp.tool(name="get_main_activity_class", description="Fetch the main activity class as defined in the AndroidManifest.xml.") 405 | async def get_main_activity_class(offset: int = 0, count: int = 0) -> List[dict]: 406 | """Fetch the main activity class as defined in the AndroidManifest.xml. 407 | 408 | Args: 409 | None 410 | 411 | Returns: 412 | Dictionary containing content of main activity class defined in AndroidManifest.xml file. 413 | """ 414 | return await get_from_jadx("main-activity") 415 | 416 | if __name__ == "__main__": 417 | logger.info("JADX MCP SERVER\n - By ZinjaCoder (https://github.com/zinja-coder) \n - To Report Issues: https://github.com/zinja-coder/jadx-mcp-server/issues\n") 418 | mcp.run(transport="stdio") 419 | -------------------------------------------------------------------------------- /pyproject.toml: -------------------------------------------------------------------------------- 1 | [project] 2 | name = "jadx-mcp-server" 3 | version = "0.1.0" 4 | description = "Add your description here" 5 | readme = "README.md" 6 | requires-python = ">=3.13" 7 | dependencies = [ 8 | "httpx>=0.28.1", 9 | "mcp[cli]>=1.6.0", 10 | "requests>=2.32.3", 11 | ] 12 | -------------------------------------------------------------------------------- /requirements.txt: -------------------------------------------------------------------------------- 1 | httpx 2 | fastmcp -------------------------------------------------------------------------------- /static/image.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zinja-coder/jadx-mcp-server/94ab3682209e507a0b203542b10ddd6eb79cdb79/static/image.png -------------------------------------------------------------------------------- /uv.lock: -------------------------------------------------------------------------------- 1 | version = 1 2 | revision = 1 3 | requires-python = ">=3.13" 4 | 5 | [[package]] 6 | name = "annotated-types" 7 | version = "0.7.0" 8 | source = { registry = "https://pypi.org/simple" } 9 | sdist = { url = "https://files.pythonhosted.org/packages/ee/67/531ea369ba64dcff5ec9c3402f9f51bf748cec26dde048a2f973a4eea7f5/annotated_types-0.7.0.tar.gz", hash = "sha256:aff07c09a53a08bc8cfccb9c85b05f1aa9a2a6f23728d790723543408344ce89", size = 16081 } 10 | wheels = [ 11 | { url = "https://files.pythonhosted.org/packages/78/b6/6307fbef88d9b5ee7421e68d78a9f162e0da4900bc5f5793f6d3d0e34fb8/annotated_types-0.7.0-py3-none-any.whl", hash = "sha256:1f02e8b43a8fbbc3f3e0d4f0f4bfc8131bcb4eebe8849b8e5c773f3a1c582a53", size = 13643 }, 12 | ] 13 | 14 | [[package]] 15 | name = "anyio" 16 | version = "4.9.0" 17 | source = { registry = "https://pypi.org/simple" } 18 | dependencies = [ 19 | { name = "idna" }, 20 | { name = "sniffio" }, 21 | ] 22 | sdist = { url = "https://files.pythonhosted.org/packages/95/7d/4c1bd541d4dffa1b52bd83fb8527089e097a106fc90b467a7313b105f840/anyio-4.9.0.tar.gz", hash = "sha256:673c0c244e15788651a4ff38710fea9675823028a6f08a5eda409e0c9840a028", size = 190949 } 23 | wheels = [ 24 | { url = "https://files.pythonhosted.org/packages/a1/ee/48ca1a7c89ffec8b6a0c5d02b89c305671d5ffd8d3c94acf8b8c408575bb/anyio-4.9.0-py3-none-any.whl", hash = "sha256:9f76d541cad6e36af7beb62e978876f3b41e3e04f2c1fbf0884604c0a9c4d93c", size = 100916 }, 25 | ] 26 | 27 | [[package]] 28 | name = "certifi" 29 | version = "2025.1.31" 30 | source = { registry = "https://pypi.org/simple" } 31 | sdist = { url = "https://files.pythonhosted.org/packages/1c/ab/c9f1e32b7b1bf505bf26f0ef697775960db7932abeb7b516de930ba2705f/certifi-2025.1.31.tar.gz", hash = "sha256:3d5da6925056f6f18f119200434a4780a94263f10d1c21d032a6f6b2baa20651", size = 167577 } 32 | wheels = [ 33 | { url = "https://files.pythonhosted.org/packages/38/fc/bce832fd4fd99766c04d1ee0eead6b0ec6486fb100ae5e74c1d91292b982/certifi-2025.1.31-py3-none-any.whl", hash = "sha256:ca78db4565a652026a4db2bcdf68f2fb589ea80d0be70e03929ed730746b84fe", size = 166393 }, 34 | ] 35 | 36 | [[package]] 37 | name = "charset-normalizer" 38 | version = "3.4.1" 39 | source = { registry = "https://pypi.org/simple" } 40 | sdist = { url = "https://files.pythonhosted.org/packages/16/b0/572805e227f01586461c80e0fd25d65a2115599cc9dad142fee4b747c357/charset_normalizer-3.4.1.tar.gz", hash = "sha256:44251f18cd68a75b56585dd00dae26183e102cd5e0f9f1466e6df5da2ed64ea3", size = 123188 } 41 | wheels = [ 42 | { url = "https://files.pythonhosted.org/packages/38/94/ce8e6f63d18049672c76d07d119304e1e2d7c6098f0841b51c666e9f44a0/charset_normalizer-3.4.1-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:aabfa34badd18f1da5ec1bc2715cadc8dca465868a4e73a0173466b688f29dda", size = 195698 }, 43 | { url = "https://files.pythonhosted.org/packages/24/2e/dfdd9770664aae179a96561cc6952ff08f9a8cd09a908f259a9dfa063568/charset_normalizer-3.4.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:22e14b5d70560b8dd51ec22863f370d1e595ac3d024cb8ad7d308b4cd95f8313", size = 140162 }, 44 | { url = "https://files.pythonhosted.org/packages/24/4e/f646b9093cff8fc86f2d60af2de4dc17c759de9d554f130b140ea4738ca6/charset_normalizer-3.4.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:8436c508b408b82d87dc5f62496973a1805cd46727c34440b0d29d8a2f50a6c9", size = 150263 }, 45 | { url = "https://files.pythonhosted.org/packages/5e/67/2937f8d548c3ef6e2f9aab0f6e21001056f692d43282b165e7c56023e6dd/charset_normalizer-3.4.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2d074908e1aecee37a7635990b2c6d504cd4766c7bc9fc86d63f9c09af3fa11b", size = 142966 }, 46 | { url = "https://files.pythonhosted.org/packages/52/ed/b7f4f07de100bdb95c1756d3a4d17b90c1a3c53715c1a476f8738058e0fa/charset_normalizer-3.4.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:955f8851919303c92343d2f66165294848d57e9bba6cf6e3625485a70a038d11", size = 144992 }, 47 | { url = "https://files.pythonhosted.org/packages/96/2c/d49710a6dbcd3776265f4c923bb73ebe83933dfbaa841c5da850fe0fd20b/charset_normalizer-3.4.1-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:44ecbf16649486d4aebafeaa7ec4c9fed8b88101f4dd612dcaf65d5e815f837f", size = 147162 }, 48 | { url = "https://files.pythonhosted.org/packages/b4/41/35ff1f9a6bd380303dea55e44c4933b4cc3c4850988927d4082ada230273/charset_normalizer-3.4.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:0924e81d3d5e70f8126529951dac65c1010cdf117bb75eb02dd12339b57749dd", size = 140972 }, 49 | { url = "https://files.pythonhosted.org/packages/fb/43/c6a0b685fe6910d08ba971f62cd9c3e862a85770395ba5d9cad4fede33ab/charset_normalizer-3.4.1-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:2967f74ad52c3b98de4c3b32e1a44e32975e008a9cd2a8cc8966d6a5218c5cb2", size = 149095 }, 50 | { url = "https://files.pythonhosted.org/packages/4c/ff/a9a504662452e2d2878512115638966e75633519ec11f25fca3d2049a94a/charset_normalizer-3.4.1-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:c75cb2a3e389853835e84a2d8fb2b81a10645b503eca9bcb98df6b5a43eb8886", size = 152668 }, 51 | { url = "https://files.pythonhosted.org/packages/6c/71/189996b6d9a4b932564701628af5cee6716733e9165af1d5e1b285c530ed/charset_normalizer-3.4.1-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:09b26ae6b1abf0d27570633b2b078a2a20419c99d66fb2823173d73f188ce601", size = 150073 }, 52 | { url = "https://files.pythonhosted.org/packages/e4/93/946a86ce20790e11312c87c75ba68d5f6ad2208cfb52b2d6a2c32840d922/charset_normalizer-3.4.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:fa88b843d6e211393a37219e6a1c1df99d35e8fd90446f1118f4216e307e48cd", size = 145732 }, 53 | { url = "https://files.pythonhosted.org/packages/cd/e5/131d2fb1b0dddafc37be4f3a2fa79aa4c037368be9423061dccadfd90091/charset_normalizer-3.4.1-cp313-cp313-win32.whl", hash = "sha256:eb8178fe3dba6450a3e024e95ac49ed3400e506fd4e9e5c32d30adda88cbd407", size = 95391 }, 54 | { url = "https://files.pythonhosted.org/packages/27/f2/4f9a69cc7712b9b5ad8fdb87039fd89abba997ad5cbe690d1835d40405b0/charset_normalizer-3.4.1-cp313-cp313-win_amd64.whl", hash = "sha256:b1ac5992a838106edb89654e0aebfc24f5848ae2547d22c2c3f66454daa11971", size = 102702 }, 55 | { url = "https://files.pythonhosted.org/packages/0e/f6/65ecc6878a89bb1c23a086ea335ad4bf21a588990c3f535a227b9eea9108/charset_normalizer-3.4.1-py3-none-any.whl", hash = "sha256:d98b1668f06378c6dbefec3b92299716b931cd4e6061f3c875a71ced1780ab85", size = 49767 }, 56 | ] 57 | 58 | [[package]] 59 | name = "click" 60 | version = "8.1.8" 61 | source = { registry = "https://pypi.org/simple" } 62 | dependencies = [ 63 | { name = "colorama", marker = "sys_platform == 'win32'" }, 64 | ] 65 | sdist = { url = "https://files.pythonhosted.org/packages/b9/2e/0090cbf739cee7d23781ad4b89a9894a41538e4fcf4c31dcdd705b78eb8b/click-8.1.8.tar.gz", hash = "sha256:ed53c9d8990d83c2a27deae68e4ee337473f6330c040a31d4225c9574d16096a", size = 226593 } 66 | wheels = [ 67 | { url = "https://files.pythonhosted.org/packages/7e/d4/7ebdbd03970677812aac39c869717059dbb71a4cfc033ca6e5221787892c/click-8.1.8-py3-none-any.whl", hash = "sha256:63c132bbbed01578a06712a2d1f497bb62d9c1c0d329b7903a866228027263b2", size = 98188 }, 68 | ] 69 | 70 | [[package]] 71 | name = "colorama" 72 | version = "0.4.6" 73 | source = { registry = "https://pypi.org/simple" } 74 | sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697 } 75 | wheels = [ 76 | { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335 }, 77 | ] 78 | 79 | [[package]] 80 | name = "h11" 81 | version = "0.14.0" 82 | source = { registry = "https://pypi.org/simple" } 83 | sdist = { url = "https://files.pythonhosted.org/packages/f5/38/3af3d3633a34a3316095b39c8e8fb4853a28a536e55d347bd8d8e9a14b03/h11-0.14.0.tar.gz", hash = "sha256:8f19fbbe99e72420ff35c00b27a34cb9937e902a8b810e2c88300c6f0a3b699d", size = 100418 } 84 | wheels = [ 85 | { url = "https://files.pythonhosted.org/packages/95/04/ff642e65ad6b90db43e668d70ffb6736436c7ce41fcc549f4e9472234127/h11-0.14.0-py3-none-any.whl", hash = "sha256:e3fe4ac4b851c468cc8363d500db52c2ead036020723024a109d37346efaa761", size = 58259 }, 86 | ] 87 | 88 | [[package]] 89 | name = "httpcore" 90 | version = "1.0.7" 91 | source = { registry = "https://pypi.org/simple" } 92 | dependencies = [ 93 | { name = "certifi" }, 94 | { name = "h11" }, 95 | ] 96 | sdist = { url = "https://files.pythonhosted.org/packages/6a/41/d7d0a89eb493922c37d343b607bc1b5da7f5be7e383740b4753ad8943e90/httpcore-1.0.7.tar.gz", hash = "sha256:8551cb62a169ec7162ac7be8d4817d561f60e08eaa485234898414bb5a8a0b4c", size = 85196 } 97 | wheels = [ 98 | { url = "https://files.pythonhosted.org/packages/87/f5/72347bc88306acb359581ac4d52f23c0ef445b57157adedb9aee0cd689d2/httpcore-1.0.7-py3-none-any.whl", hash = "sha256:a3fff8f43dc260d5bd363d9f9cf1830fa3a458b332856f34282de498ed420edd", size = 78551 }, 99 | ] 100 | 101 | [[package]] 102 | name = "httpx" 103 | version = "0.28.1" 104 | source = { registry = "https://pypi.org/simple" } 105 | dependencies = [ 106 | { name = "anyio" }, 107 | { name = "certifi" }, 108 | { name = "httpcore" }, 109 | { name = "idna" }, 110 | ] 111 | sdist = { url = "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc", size = 141406 } 112 | wheels = [ 113 | { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517 }, 114 | ] 115 | 116 | [[package]] 117 | name = "httpx-sse" 118 | version = "0.4.0" 119 | source = { registry = "https://pypi.org/simple" } 120 | sdist = { url = "https://files.pythonhosted.org/packages/4c/60/8f4281fa9bbf3c8034fd54c0e7412e66edbab6bc74c4996bd616f8d0406e/httpx-sse-0.4.0.tar.gz", hash = "sha256:1e81a3a3070ce322add1d3529ed42eb5f70817f45ed6ec915ab753f961139721", size = 12624 } 121 | wheels = [ 122 | { url = "https://files.pythonhosted.org/packages/e1/9b/a181f281f65d776426002f330c31849b86b31fc9d848db62e16f03ff739f/httpx_sse-0.4.0-py3-none-any.whl", hash = "sha256:f329af6eae57eaa2bdfd962b42524764af68075ea87370a2de920af5341e318f", size = 7819 }, 123 | ] 124 | 125 | [[package]] 126 | name = "idna" 127 | version = "3.10" 128 | source = { registry = "https://pypi.org/simple" } 129 | sdist = { url = "https://files.pythonhosted.org/packages/f1/70/7703c29685631f5a7590aa73f1f1d3fa9a380e654b86af429e0934a32f7d/idna-3.10.tar.gz", hash = "sha256:12f65c9b470abda6dc35cf8e63cc574b1c52b11df2c86030af0ac09b01b13ea9", size = 190490 } 130 | wheels = [ 131 | { url = "https://files.pythonhosted.org/packages/76/c6/c88e154df9c4e1a2a66ccf0005a88dfb2650c1dffb6f5ce603dfbd452ce3/idna-3.10-py3-none-any.whl", hash = "sha256:946d195a0d259cbba61165e88e65941f16e9b36ea6ddb97f00452bae8b1287d3", size = 70442 }, 132 | ] 133 | 134 | [[package]] 135 | name = "jadx-mcp-server" 136 | version = "0.1.0" 137 | source = { virtual = "." } 138 | dependencies = [ 139 | { name = "httpx" }, 140 | { name = "mcp", extra = ["cli"] }, 141 | { name = "requests" }, 142 | ] 143 | 144 | [package.metadata] 145 | requires-dist = [ 146 | { name = "httpx", specifier = ">=0.28.1" }, 147 | { name = "mcp", extras = ["cli"], specifier = ">=1.6.0" }, 148 | { name = "requests", specifier = ">=2.32.3" }, 149 | ] 150 | 151 | [[package]] 152 | name = "markdown-it-py" 153 | version = "3.0.0" 154 | source = { registry = "https://pypi.org/simple" } 155 | dependencies = [ 156 | { name = "mdurl" }, 157 | ] 158 | sdist = { url = "https://files.pythonhosted.org/packages/38/71/3b932df36c1a044d397a1f92d1cf91ee0a503d91e470cbd670aa66b07ed0/markdown-it-py-3.0.0.tar.gz", hash = "sha256:e3f60a94fa066dc52ec76661e37c851cb232d92f9886b15cb560aaada2df8feb", size = 74596 } 159 | wheels = [ 160 | { url = "https://files.pythonhosted.org/packages/42/d7/1ec15b46af6af88f19b8e5ffea08fa375d433c998b8a7639e76935c14f1f/markdown_it_py-3.0.0-py3-none-any.whl", hash = "sha256:355216845c60bd96232cd8d8c40e8f9765cc86f46880e43a8fd22dc1a1a8cab1", size = 87528 }, 161 | ] 162 | 163 | [[package]] 164 | name = "mcp" 165 | version = "1.6.0" 166 | source = { registry = "https://pypi.org/simple" } 167 | dependencies = [ 168 | { name = "anyio" }, 169 | { name = "httpx" }, 170 | { name = "httpx-sse" }, 171 | { name = "pydantic" }, 172 | { name = "pydantic-settings" }, 173 | { name = "sse-starlette" }, 174 | { name = "starlette" }, 175 | { name = "uvicorn" }, 176 | ] 177 | sdist = { url = "https://files.pythonhosted.org/packages/95/d2/f587cb965a56e992634bebc8611c5b579af912b74e04eb9164bd49527d21/mcp-1.6.0.tar.gz", hash = "sha256:d9324876de2c5637369f43161cd71eebfd803df5a95e46225cab8d280e366723", size = 200031 } 178 | wheels = [ 179 | { url = "https://files.pythonhosted.org/packages/10/30/20a7f33b0b884a9d14dd3aa94ff1ac9da1479fe2ad66dd9e2736075d2506/mcp-1.6.0-py3-none-any.whl", hash = "sha256:7bd24c6ea042dbec44c754f100984d186620d8b841ec30f1b19eda9b93a634d0", size = 76077 }, 180 | ] 181 | 182 | [package.optional-dependencies] 183 | cli = [ 184 | { name = "python-dotenv" }, 185 | { name = "typer" }, 186 | ] 187 | 188 | [[package]] 189 | name = "mdurl" 190 | version = "0.1.2" 191 | source = { registry = "https://pypi.org/simple" } 192 | sdist = { url = "https://files.pythonhosted.org/packages/d6/54/cfe61301667036ec958cb99bd3efefba235e65cdeb9c84d24a8293ba1d90/mdurl-0.1.2.tar.gz", hash = "sha256:bb413d29f5eea38f31dd4754dd7377d4465116fb207585f97bf925588687c1ba", size = 8729 } 193 | wheels = [ 194 | { url = "https://files.pythonhosted.org/packages/b3/38/89ba8ad64ae25be8de66a6d463314cf1eb366222074cfda9ee839c56a4b4/mdurl-0.1.2-py3-none-any.whl", hash = "sha256:84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8", size = 9979 }, 195 | ] 196 | 197 | [[package]] 198 | name = "pydantic" 199 | version = "2.11.2" 200 | source = { registry = "https://pypi.org/simple" } 201 | dependencies = [ 202 | { name = "annotated-types" }, 203 | { name = "pydantic-core" }, 204 | { name = "typing-extensions" }, 205 | { name = "typing-inspection" }, 206 | ] 207 | sdist = { url = "https://files.pythonhosted.org/packages/b0/41/832125a41fe098b58d1fdd04ae819b4dc6b34d6b09ed78304fd93d4bc051/pydantic-2.11.2.tar.gz", hash = "sha256:2138628e050bd7a1e70b91d4bf4a91167f4ad76fdb83209b107c8d84b854917e", size = 784742 } 208 | wheels = [ 209 | { url = "https://files.pythonhosted.org/packages/bf/c2/0f3baea344d0b15e35cb3e04ad5b953fa05106b76efbf4c782a3f47f22f5/pydantic-2.11.2-py3-none-any.whl", hash = "sha256:7f17d25846bcdf89b670a86cdfe7b29a9f1c9ca23dee154221c9aa81845cfca7", size = 443295 }, 210 | ] 211 | 212 | [[package]] 213 | name = "pydantic-core" 214 | version = "2.33.1" 215 | source = { registry = "https://pypi.org/simple" } 216 | dependencies = [ 217 | { name = "typing-extensions" }, 218 | ] 219 | sdist = { url = "https://files.pythonhosted.org/packages/17/19/ed6a078a5287aea7922de6841ef4c06157931622c89c2a47940837b5eecd/pydantic_core-2.33.1.tar.gz", hash = "sha256:bcc9c6fdb0ced789245b02b7d6603e17d1563064ddcfc36f046b61c0c05dd9df", size = 434395 } 220 | wheels = [ 221 | { url = "https://files.pythonhosted.org/packages/7a/24/eed3466a4308d79155f1cdd5c7432c80ddcc4530ba8623b79d5ced021641/pydantic_core-2.33.1-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:70af6a21237b53d1fe7b9325b20e65cbf2f0a848cf77bed492b029139701e66a", size = 2033551 }, 222 | { url = "https://files.pythonhosted.org/packages/ab/14/df54b1a0bc9b6ded9b758b73139d2c11b4e8eb43e8ab9c5847c0a2913ada/pydantic_core-2.33.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:282b3fe1bbbe5ae35224a0dbd05aed9ccabccd241e8e6b60370484234b456266", size = 1852785 }, 223 | { url = "https://files.pythonhosted.org/packages/fa/96/e275f15ff3d34bb04b0125d9bc8848bf69f25d784d92a63676112451bfb9/pydantic_core-2.33.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4b315e596282bbb5822d0c7ee9d255595bd7506d1cb20c2911a4da0b970187d3", size = 1897758 }, 224 | { url = "https://files.pythonhosted.org/packages/b7/d8/96bc536e975b69e3a924b507d2a19aedbf50b24e08c80fb00e35f9baaed8/pydantic_core-2.33.1-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:1dfae24cf9921875ca0ca6a8ecb4bb2f13c855794ed0d468d6abbec6e6dcd44a", size = 1986109 }, 225 | { url = "https://files.pythonhosted.org/packages/90/72/ab58e43ce7e900b88cb571ed057b2fcd0e95b708a2e0bed475b10130393e/pydantic_core-2.33.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:6dd8ecfde08d8bfadaea669e83c63939af76f4cf5538a72597016edfa3fad516", size = 2129159 }, 226 | { url = "https://files.pythonhosted.org/packages/dc/3f/52d85781406886c6870ac995ec0ba7ccc028b530b0798c9080531b409fdb/pydantic_core-2.33.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2f593494876eae852dc98c43c6f260f45abdbfeec9e4324e31a481d948214764", size = 2680222 }, 227 | { url = "https://files.pythonhosted.org/packages/f4/56/6e2ef42f363a0eec0fd92f74a91e0ac48cd2e49b695aac1509ad81eee86a/pydantic_core-2.33.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:948b73114f47fd7016088e5186d13faf5e1b2fe83f5e320e371f035557fd264d", size = 2006980 }, 228 | { url = "https://files.pythonhosted.org/packages/4c/c0/604536c4379cc78359f9ee0aa319f4aedf6b652ec2854953f5a14fc38c5a/pydantic_core-2.33.1-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:e11f3864eb516af21b01e25fac915a82e9ddad3bb0fb9e95a246067398b435a4", size = 2120840 }, 229 | { url = "https://files.pythonhosted.org/packages/1f/46/9eb764814f508f0edfb291a0f75d10854d78113fa13900ce13729aaec3ae/pydantic_core-2.33.1-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:549150be302428b56fdad0c23c2741dcdb5572413776826c965619a25d9c6bde", size = 2072518 }, 230 | { url = "https://files.pythonhosted.org/packages/42/e3/fb6b2a732b82d1666fa6bf53e3627867ea3131c5f39f98ce92141e3e3dc1/pydantic_core-2.33.1-cp313-cp313-musllinux_1_1_armv7l.whl", hash = "sha256:495bc156026efafd9ef2d82372bd38afce78ddd82bf28ef5276c469e57c0c83e", size = 2248025 }, 231 | { url = "https://files.pythonhosted.org/packages/5c/9d/fbe8fe9d1aa4dac88723f10a921bc7418bd3378a567cb5e21193a3c48b43/pydantic_core-2.33.1-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:ec79de2a8680b1a67a07490bddf9636d5c2fab609ba8c57597e855fa5fa4dacd", size = 2254991 }, 232 | { url = "https://files.pythonhosted.org/packages/aa/99/07e2237b8a66438d9b26482332cda99a9acccb58d284af7bc7c946a42fd3/pydantic_core-2.33.1-cp313-cp313-win32.whl", hash = "sha256:ee12a7be1742f81b8a65b36c6921022301d466b82d80315d215c4c691724986f", size = 1915262 }, 233 | { url = "https://files.pythonhosted.org/packages/8a/f4/e457a7849beeed1e5defbcf5051c6f7b3c91a0624dd31543a64fc9adcf52/pydantic_core-2.33.1-cp313-cp313-win_amd64.whl", hash = "sha256:ede9b407e39949d2afc46385ce6bd6e11588660c26f80576c11c958e6647bc40", size = 1956626 }, 234 | { url = "https://files.pythonhosted.org/packages/20/d0/e8d567a7cff7b04e017ae164d98011f1e1894269fe8e90ea187a3cbfb562/pydantic_core-2.33.1-cp313-cp313-win_arm64.whl", hash = "sha256:aa687a23d4b7871a00e03ca96a09cad0f28f443690d300500603bd0adba4b523", size = 1909590 }, 235 | { url = "https://files.pythonhosted.org/packages/ef/fd/24ea4302d7a527d672c5be06e17df16aabfb4e9fdc6e0b345c21580f3d2a/pydantic_core-2.33.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:401d7b76e1000d0dd5538e6381d28febdcacb097c8d340dde7d7fc6e13e9f95d", size = 1812963 }, 236 | { url = "https://files.pythonhosted.org/packages/5f/95/4fbc2ecdeb5c1c53f1175a32d870250194eb2fdf6291b795ab08c8646d5d/pydantic_core-2.33.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7aeb055a42d734c0255c9e489ac67e75397d59c6fbe60d155851e9782f276a9c", size = 1986896 }, 237 | { url = "https://files.pythonhosted.org/packages/71/ae/fe31e7f4a62431222d8f65a3bd02e3fa7e6026d154a00818e6d30520ea77/pydantic_core-2.33.1-cp313-cp313t-win_amd64.whl", hash = "sha256:338ea9b73e6e109f15ab439e62cb3b78aa752c7fd9536794112e14bee02c8d18", size = 1931810 }, 238 | ] 239 | 240 | [[package]] 241 | name = "pydantic-settings" 242 | version = "2.8.1" 243 | source = { registry = "https://pypi.org/simple" } 244 | dependencies = [ 245 | { name = "pydantic" }, 246 | { name = "python-dotenv" }, 247 | ] 248 | sdist = { url = "https://files.pythonhosted.org/packages/88/82/c79424d7d8c29b994fb01d277da57b0a9b09cc03c3ff875f9bd8a86b2145/pydantic_settings-2.8.1.tar.gz", hash = "sha256:d5c663dfbe9db9d5e1c646b2e161da12f0d734d422ee56f567d0ea2cee4e8585", size = 83550 } 249 | wheels = [ 250 | { url = "https://files.pythonhosted.org/packages/0b/53/a64f03044927dc47aafe029c42a5b7aabc38dfb813475e0e1bf71c4a59d0/pydantic_settings-2.8.1-py3-none-any.whl", hash = "sha256:81942d5ac3d905f7f3ee1a70df5dfb62d5569c12f51a5a647defc1c3d9ee2e9c", size = 30839 }, 251 | ] 252 | 253 | [[package]] 254 | name = "pygments" 255 | version = "2.19.1" 256 | source = { registry = "https://pypi.org/simple" } 257 | sdist = { url = "https://files.pythonhosted.org/packages/7c/2d/c3338d48ea6cc0feb8446d8e6937e1408088a72a39937982cc6111d17f84/pygments-2.19.1.tar.gz", hash = "sha256:61c16d2a8576dc0649d9f39e089b5f02bcd27fba10d8fb4dcc28173f7a45151f", size = 4968581 } 258 | wheels = [ 259 | { url = "https://files.pythonhosted.org/packages/8a/0b/9fcc47d19c48b59121088dd6da2488a49d5f72dacf8262e2790a1d2c7d15/pygments-2.19.1-py3-none-any.whl", hash = "sha256:9ea1544ad55cecf4b8242fab6dd35a93bbce657034b0611ee383099054ab6d8c", size = 1225293 }, 260 | ] 261 | 262 | [[package]] 263 | name = "python-dotenv" 264 | version = "1.1.0" 265 | source = { registry = "https://pypi.org/simple" } 266 | sdist = { url = "https://files.pythonhosted.org/packages/88/2c/7bb1416c5620485aa793f2de31d3df393d3686aa8a8506d11e10e13c5baf/python_dotenv-1.1.0.tar.gz", hash = "sha256:41f90bc6f5f177fb41f53e87666db362025010eb28f60a01c9143bfa33a2b2d5", size = 39920 } 267 | wheels = [ 268 | { url = "https://files.pythonhosted.org/packages/1e/18/98a99ad95133c6a6e2005fe89faedf294a748bd5dc803008059409ac9b1e/python_dotenv-1.1.0-py3-none-any.whl", hash = "sha256:d7c01d9e2293916c18baf562d95698754b0dbbb5e74d457c45d4f6561fb9d55d", size = 20256 }, 269 | ] 270 | 271 | [[package]] 272 | name = "requests" 273 | version = "2.32.3" 274 | source = { registry = "https://pypi.org/simple" } 275 | dependencies = [ 276 | { name = "certifi" }, 277 | { name = "charset-normalizer" }, 278 | { name = "idna" }, 279 | { name = "urllib3" }, 280 | ] 281 | sdist = { url = "https://files.pythonhosted.org/packages/63/70/2bf7780ad2d390a8d301ad0b550f1581eadbd9a20f896afe06353c2a2913/requests-2.32.3.tar.gz", hash = "sha256:55365417734eb18255590a9ff9eb97e9e1da868d4ccd6402399eaf68af20a760", size = 131218 } 282 | wheels = [ 283 | { url = "https://files.pythonhosted.org/packages/f9/9b/335f9764261e915ed497fcdeb11df5dfd6f7bf257d4a6a2a686d80da4d54/requests-2.32.3-py3-none-any.whl", hash = "sha256:70761cfe03c773ceb22aa2f671b4757976145175cdfca038c02654d061d6dcc6", size = 64928 }, 284 | ] 285 | 286 | [[package]] 287 | name = "rich" 288 | version = "14.0.0" 289 | source = { registry = "https://pypi.org/simple" } 290 | dependencies = [ 291 | { name = "markdown-it-py" }, 292 | { name = "pygments" }, 293 | ] 294 | sdist = { url = "https://files.pythonhosted.org/packages/a1/53/830aa4c3066a8ab0ae9a9955976fb770fe9c6102117c8ec4ab3ea62d89e8/rich-14.0.0.tar.gz", hash = "sha256:82f1bc23a6a21ebca4ae0c45af9bdbc492ed20231dcb63f297d6d1021a9d5725", size = 224078 } 295 | wheels = [ 296 | { url = "https://files.pythonhosted.org/packages/0d/9b/63f4c7ebc259242c89b3acafdb37b41d1185c07ff0011164674e9076b491/rich-14.0.0-py3-none-any.whl", hash = "sha256:1c9491e1951aac09caffd42f448ee3d04e58923ffe14993f6e83068dc395d7e0", size = 243229 }, 297 | ] 298 | 299 | [[package]] 300 | name = "shellingham" 301 | version = "1.5.4" 302 | source = { registry = "https://pypi.org/simple" } 303 | sdist = { url = "https://files.pythonhosted.org/packages/58/15/8b3609fd3830ef7b27b655beb4b4e9c62313a4e8da8c676e142cc210d58e/shellingham-1.5.4.tar.gz", hash = "sha256:8dbca0739d487e5bd35ab3ca4b36e11c4078f3a234bfce294b0a0291363404de", size = 10310 } 304 | wheels = [ 305 | { url = "https://files.pythonhosted.org/packages/e0/f9/0595336914c5619e5f28a1fb793285925a8cd4b432c9da0a987836c7f822/shellingham-1.5.4-py2.py3-none-any.whl", hash = "sha256:7ecfff8f2fd72616f7481040475a65b2bf8af90a56c89140852d1120324e8686", size = 9755 }, 306 | ] 307 | 308 | [[package]] 309 | name = "sniffio" 310 | version = "1.3.1" 311 | source = { registry = "https://pypi.org/simple" } 312 | sdist = { url = "https://files.pythonhosted.org/packages/a2/87/a6771e1546d97e7e041b6ae58d80074f81b7d5121207425c964ddf5cfdbd/sniffio-1.3.1.tar.gz", hash = "sha256:f4324edc670a0f49750a81b895f35c3adb843cca46f0530f79fc1babb23789dc", size = 20372 } 313 | wheels = [ 314 | { url = "https://files.pythonhosted.org/packages/e9/44/75a9c9421471a6c4805dbf2356f7c181a29c1879239abab1ea2cc8f38b40/sniffio-1.3.1-py3-none-any.whl", hash = "sha256:2f6da418d1f1e0fddd844478f41680e794e6051915791a034ff65e5f100525a2", size = 10235 }, 315 | ] 316 | 317 | [[package]] 318 | name = "sse-starlette" 319 | version = "2.2.1" 320 | source = { registry = "https://pypi.org/simple" } 321 | dependencies = [ 322 | { name = "anyio" }, 323 | { name = "starlette" }, 324 | ] 325 | sdist = { url = "https://files.pythonhosted.org/packages/71/a4/80d2a11af59fe75b48230846989e93979c892d3a20016b42bb44edb9e398/sse_starlette-2.2.1.tar.gz", hash = "sha256:54470d5f19274aeed6b2d473430b08b4b379ea851d953b11d7f1c4a2c118b419", size = 17376 } 326 | wheels = [ 327 | { url = "https://files.pythonhosted.org/packages/d9/e0/5b8bd393f27f4a62461c5cf2479c75a2cc2ffa330976f9f00f5f6e4f50eb/sse_starlette-2.2.1-py3-none-any.whl", hash = "sha256:6410a3d3ba0c89e7675d4c273a301d64649c03a5ef1ca101f10b47f895fd0e99", size = 10120 }, 328 | ] 329 | 330 | [[package]] 331 | name = "starlette" 332 | version = "0.46.1" 333 | source = { registry = "https://pypi.org/simple" } 334 | dependencies = [ 335 | { name = "anyio" }, 336 | ] 337 | sdist = { url = "https://files.pythonhosted.org/packages/04/1b/52b27f2e13ceedc79a908e29eac426a63465a1a01248e5f24aa36a62aeb3/starlette-0.46.1.tar.gz", hash = "sha256:3c88d58ee4bd1bb807c0d1acb381838afc7752f9ddaec81bbe4383611d833230", size = 2580102 } 338 | wheels = [ 339 | { url = "https://files.pythonhosted.org/packages/a0/4b/528ccf7a982216885a1ff4908e886b8fb5f19862d1962f56a3fce2435a70/starlette-0.46.1-py3-none-any.whl", hash = "sha256:77c74ed9d2720138b25875133f3a2dae6d854af2ec37dceb56aef370c1d8a227", size = 71995 }, 340 | ] 341 | 342 | [[package]] 343 | name = "typer" 344 | version = "0.15.2" 345 | source = { registry = "https://pypi.org/simple" } 346 | dependencies = [ 347 | { name = "click" }, 348 | { name = "rich" }, 349 | { name = "shellingham" }, 350 | { name = "typing-extensions" }, 351 | ] 352 | sdist = { url = "https://files.pythonhosted.org/packages/8b/6f/3991f0f1c7fcb2df31aef28e0594d8d54b05393a0e4e34c65e475c2a5d41/typer-0.15.2.tar.gz", hash = "sha256:ab2fab47533a813c49fe1f16b1a370fd5819099c00b119e0633df65f22144ba5", size = 100711 } 353 | wheels = [ 354 | { url = "https://files.pythonhosted.org/packages/7f/fc/5b29fea8cee020515ca82cc68e3b8e1e34bb19a3535ad854cac9257b414c/typer-0.15.2-py3-none-any.whl", hash = "sha256:46a499c6107d645a9c13f7ee46c5d5096cae6f5fc57dd11eccbbb9ae3e44ddfc", size = 45061 }, 355 | ] 356 | 357 | [[package]] 358 | name = "typing-extensions" 359 | version = "4.13.1" 360 | source = { registry = "https://pypi.org/simple" } 361 | sdist = { url = "https://files.pythonhosted.org/packages/76/ad/cd3e3465232ec2416ae9b983f27b9e94dc8171d56ac99b345319a9475967/typing_extensions-4.13.1.tar.gz", hash = "sha256:98795af00fb9640edec5b8e31fc647597b4691f099ad75f469a2616be1a76dff", size = 106633 } 362 | wheels = [ 363 | { url = "https://files.pythonhosted.org/packages/df/c5/e7a0b0f5ed69f94c8ab7379c599e6036886bffcde609969a5325f47f1332/typing_extensions-4.13.1-py3-none-any.whl", hash = "sha256:4b6cf02909eb5495cfbc3f6e8fd49217e6cc7944e145cdda8caa3734777f9e69", size = 45739 }, 364 | ] 365 | 366 | [[package]] 367 | name = "typing-inspection" 368 | version = "0.4.0" 369 | source = { registry = "https://pypi.org/simple" } 370 | dependencies = [ 371 | { name = "typing-extensions" }, 372 | ] 373 | sdist = { url = "https://files.pythonhosted.org/packages/82/5c/e6082df02e215b846b4b8c0b887a64d7d08ffaba30605502639d44c06b82/typing_inspection-0.4.0.tar.gz", hash = "sha256:9765c87de36671694a67904bf2c96e395be9c6439bb6c87b5142569dcdd65122", size = 76222 } 374 | wheels = [ 375 | { url = "https://files.pythonhosted.org/packages/31/08/aa4fdfb71f7de5176385bd9e90852eaf6b5d622735020ad600f2bab54385/typing_inspection-0.4.0-py3-none-any.whl", hash = "sha256:50e72559fcd2a6367a19f7a7e610e6afcb9fac940c650290eed893d61386832f", size = 14125 }, 376 | ] 377 | 378 | [[package]] 379 | name = "urllib3" 380 | version = "2.3.0" 381 | source = { registry = "https://pypi.org/simple" } 382 | sdist = { url = "https://files.pythonhosted.org/packages/aa/63/e53da845320b757bf29ef6a9062f5c669fe997973f966045cb019c3f4b66/urllib3-2.3.0.tar.gz", hash = "sha256:f8c5449b3cf0861679ce7e0503c7b44b5ec981bec0d1d3795a07f1ba96f0204d", size = 307268 } 383 | wheels = [ 384 | { url = "https://files.pythonhosted.org/packages/c8/19/4ec628951a74043532ca2cf5d97b7b14863931476d117c471e8e2b1eb39f/urllib3-2.3.0-py3-none-any.whl", hash = "sha256:1cee9ad369867bfdbbb48b7dd50374c0967a0bb7710050facf0dd6911440e3df", size = 128369 }, 385 | ] 386 | 387 | [[package]] 388 | name = "uvicorn" 389 | version = "0.34.0" 390 | source = { registry = "https://pypi.org/simple" } 391 | dependencies = [ 392 | { name = "click" }, 393 | { name = "h11" }, 394 | ] 395 | sdist = { url = "https://files.pythonhosted.org/packages/4b/4d/938bd85e5bf2edeec766267a5015ad969730bb91e31b44021dfe8b22df6c/uvicorn-0.34.0.tar.gz", hash = "sha256:404051050cd7e905de2c9a7e61790943440b3416f49cb409f965d9dcd0fa73e9", size = 76568 } 396 | wheels = [ 397 | { url = "https://files.pythonhosted.org/packages/61/14/33a3a1352cfa71812a3a21e8c9bfb83f60b0011f5e36f2b1399d51928209/uvicorn-0.34.0-py3-none-any.whl", hash = "sha256:023dc038422502fa28a09c7a30bf2b6991512da7dcdb8fd35fe57cfc154126f4", size = 62315 }, 398 | ] 399 | --------------------------------------------------------------------------------