Sampreeth S J

🎉 amanmcp - Your Local Code Search Assistant

🚀 Getting Started

AmanMCP is your go-to tool for searching code. It helps you find what you need quickly and easily, making your development work smooth and efficient.

📥 Download Link

📂 Overview

AmanMCP is a local-first RAG MCP server designed for developers. It combines simple search tools with advanced features like semantic search to assist tools such as Claude Code and Cursor in helping you navigate your codebase. Whether you are looking for specific functions, files, or just exploring, AmanMCP is built to enhance your coding experience.

💻 System Requirements

Before you download, ensure your system meets these basic requirements:

• Operating System: Windows 10 or newer, macOS 10.15 or newer, or any modern Linux distribution.
• Memory: 4 GB of RAM minimum, 8 GB recommended.
• Disk Space: At least 100 MB of free space.
• Network: An internet connection for downloading dependencies.

🔍 Features

• Hybrid Search: Combine BM25 and semantic search to find relevant code snippets.
• Local-first Approach: Everything runs on your machine, ensuring speed and privacy.
• Integration-Friendly: Works well with AI assistants like Claude Code and Cursor.
• Easy Navigation: Quickly search across your entire codebase.
• Support for Multiple Languages: Ideal for developers working with various programming languages.

🔄 How to Download & Install AmanMCP

1. Visit the Releases Page to find the latest version of AmanMCP.
2. Look for the latest release. It should be listed at the top with version numbers like v1.0, v1.1, etc.
3. Click on the release to expand it. You will see different files available for download.
4. Download the version suitable for your operating system.
   • For Windows, look for a file ending with .exe.
   • For macOS or Linux, find files ending with .zip or similar packages.
5. Once the download completes, go to your Downloads folder.
6. Open the downloaded file:
   • Windows: Double-click the .exe file to start the installation.
   • macOS: Double-click the .zip file to extract it. Then move the extracted folder to your Applications.
   • Linux: Use tar -xvf to extract it. You may need to run it from the terminal.
7. Follow the on-screen instructions to complete the installation.

⚙️ Running AmanMCP

Once installed, you can start using AmanMCP easily.

• Windows: Find AmanMCP in the Start Menu and click to launch it.
• macOS: Open your Applications folder and double-click AmanMCP.
• Linux: Open the terminal. Navigate to the folder where AmanMCP is installed and run ./amanmcp.

After launching, you will see a simple interface where you can type your search queries and explore your code.

🎓 How to Use AmanMCP

Here’s a quick guide on how to search effectively:

1. Basic Search: Type a keyword or function name in the search bar and hit enter. AmanMCP will display relevant results.
2. Advanced Search: Use operators like AND and OR to refine your results. For example, searching for function AND variable will show results that contain both words.
3. Explore Options: Browse different sections like Files, Functions, and Lines for organized results.
4. Integration with AI Tools: Leverage AmanMCP with Claude Code or Cursor for enriched search capabilities.

🔄 Keeping Your Application Updated

To ensure you have the latest features and fixes, check the Releases Page regularly. It is a good practice to update once a new version is available.

❓ FAQs

What happens if I experience issues?

If you encounter problems, consider the following steps:

• Ensure you have the minimum system requirements.
• Restart the application.
• Check online resources for common issues.

Is AmanMCP free?

Yes, AmanMCP is open-source and free to use.

Can I contribute to AmanMCP?

Absolutely! We welcome contributions. Visit the repository for guidelines on how to get involved.

📢 Join the Community

For support and to share your feedback, consider joining our community. Connect with others who use AmanMCP to exchange tips and ideas.