Noor MCP Code Assistant

🚀 Noor MCP Code Assistant

MCP (Model Context Protocol) Server that bridges Claude Desktop with your RAG-powered Code Agent API.

   

---

📋 Overview

This project creates an MCP server that allows Claude Desktop to communicate with your existing RAG Code Agent API running at localhost:8900. When you ask code-related questions in Claude Desktop, it can use this tool to fetch context-aware answers from your codebase.

🎯 Features

• ✅ Seamless integration with Claude Desktop
• ✅ Connects to existing RAG API (/api/chat/rag)
• ✅ Session management for conversation continuity
• ✅ Comprehensive error handling
• ✅ Configurable via environment variables
• ✅ Ready for future agent extensions (SQL, React, Java)

---

🏗️ Project Structure

noor_mcp_code_assistant_parent/
├── env_container/              # Virtual environment
│   ├── bin/
│   ├── lib/
│   └── ...
└── noor_mcp_code_assistant/    # Project source
    ├── mcp_server.py           # Main MCP server
    ├── config.py               # Configuration management
    ├── requirements.txt        # Dependencies
    ├── .env.example            # Environment template
    ├── .env                    # Your configuration (git-ignored)
    └── README.md               # This file

---

🚀 Quick Start

1️⃣ Create Virtual Environment

Navigate to the parent folder and create the environment: ``bash cd noor_mcp_code_assistant_parent python3.11 -m venv env_container ``

Activate the environment: ```bash

Linux/WSL/macOS

source env_container/bin/activate

Windows PowerShell

.\env_container\Scripts\Activate ```

---

2️⃣ Install Requirements

cd noor_mcp_code_assistant
pip install -r requirements.txt

---

3️⃣ Configure Environment Variables

Copy the example file and customize: ``bash cp .env.example .env ``

Edit .env with your settings: ```bash

Required

RAG_API_BASE_URL=http://localhost:8900 RAG_CHAT_ENDPOINT=/api/chat/rag

Optional

DEFAULT_SESSION_ID=claude-desktop-session REQUEST_TIMEOUT=120 ```

---

4️⃣ Configure Claude Desktop

Locate your Claude Desktop configuration file:

Windows: `` %APPDATA%\Claude\claude_desktop_config.json ` (Usually: C:\Users\<YourUsername>\AppData\Roaming\Claude\claude_desktop_config.json`)

Add the MCP server configuration: ``json { "mcpServers": { "noor-code-assistant": { "command": "wsl", "args": [ "-d", "Ubuntu-20.04", "--", "/home/<your-username>/noor_mcp_code_assistant_parent/env_container/bin/python", "/home/<your-username>/noor_mcp_code_assistant_parent/noor_mcp_code_assistant/mcp_server.py" ], "env": { "PYTHONUNBUFFERED": "1" } } } } ``

⚠️ Important: Replace <your-username> with your actual WSL username and adjust paths accordingly.

🔍 Find Your WSL Distribution Name

wsl --list --verbose

Use the exact name shown (e.g., Ubuntu-20.04, Ubuntu, etc.)

---

5️⃣ Verify Setup

Step 1: Ensure your RAG API is running: ```bash

In WSL terminal

cd /path/to/your/rag-project source env_container/bin/activate uvicorn main:app --reload --port 8900 ```

Step 2: Test the RAG API: ``bash curl -X POST http://localhost:8900/api/chat/rag \ -H "Content-Type: application/json" \ -d '{"session_id": "test", "message": "hello"}' ``

Step 3: Restart Claude Desktop completely (check system tray)

Step 4: The noor-code-assistant tool should now appear in Claude Desktop!

---

💬 Usage Examples

Once configured, you can ask Claude Desktop:

"Use the code assistant to create a C# function that gets employee requests by employee ID"

"Ask the code assistant how pagination is implemented in my project"

"Use code_assistant to show me the DTO structure for Employee entity"

---

🔮 Adding Future Agents

When you're ready to add more agents (SQL, React, Java):

Step 1: Add endpoints to your RAG API

@app.post("/api/sql/agent")
async def sql_agent(request: SQLAgentRequest):
    # Your SQL agent logic
    pass

Step 2: Update .env

SQL_AGENT_ENDPOINT=/api/sql/agent

Step 3: Uncomment tool definitions in mcp_server.py

Look for the commented sql_agent tool and handler, then uncomment them.

Step 4: Restart Claude Desktop

---

🐛 Troubleshooting

| Issue | Solution | |-------|----------| | MCP server not appearing | Check Claude Desktop logs at %APPDATA%\Claude\logs\ | | Connection refused | Ensure RAG API is running on localhost:8900 | | WSL path issues | Use full Linux paths (e.g., /home/user/...) | | Python not found | Use full path to Python in venv | | Timeout errors | Increase REQUEST_TIMEOUT in .env |

📋 View Logs

Claude Desktop Logs: `` C:\Users\<YourUsername>\AppData\Roaming\Claude\logs\ ``

Test MCP Server Standalone: ``bash cd noor_mcp_code_assistant source ../env_container/bin/activate python mcp_server.py ``

---

📊 Configuration Reference

| Variable | Default | Description | |----------|---------|-------------| | RAG_API_BASE_URL | http://localhost:8900 | Base URL of your RAG API | | RAG_CHAT_ENDPOINT | /api/chat/rag | Chat endpoint path | | DEFAULT_SESSION_ID | claude-desktop-session | Default session for continuity | | REQUEST_TIMEOUT | 120 | API timeout in seconds |

---

🔐 Security Notes

• This MCP server only makes outbound HTTP requests to your local RAG API
• No sensitive data is stored or logged
• Session IDs are used only for conversation context
• All communication happens over localhost

---

📄 License

MIT License - Feel free to use and modify!

---

👨‍💻 Author

Noor Uddin

• 🎥 YouTube: Noor Codelogics
• 💼 LinkedIn: Noor Uddin
• 🛒 CodeCanyon: 180+ Sales

---

🌟 Support

If you find this helpful, please:

• ⭐ Star the repository
• 📺 Subscribe to Noor Codelogics
• 🔗 Share with fellow developers

Happy Coding! 🚀