Viincci RAG Server

A basic MCP (Model Context Protocol) server that responds with 'viincci_rag' to any prompt.

Features

• Simple tool that responds with 'viincci_rag' to any input
• HTTP transport for web deployment
• Ready for deployment on Render

Local Development

Prerequisites

• Python 3.10 or higher
• pip or uv package manager

Installation

1. Clone this repository:

git clone <your-repo-url>
cd viincci-rag-mcp

2. Install dependencies:

pip install -r requirements.txt

Running Locally

Run the server with:

python server.py

The server will start on http://localhost:8000 and the MCP endpoint will be available at http://localhost:8000/mcp.

You can also use the FastMCP CLI:

fastmcp run server.py

Or with HTTP transport:

fastmcp run server.py --transport http

Deployment on Render

Step 1: Push to GitHub

1. Create a new GitHub repository
2. Push this code to your repository:

git init
git add .
git commit -m "Initial commit: viincci_rag MCP server"
git branch -M main
git remote add origin <your-repo-url>
git push -u origin main

Step 2: Deploy on Render

1. Go to Render Dashboard

2. Click "New +" and select "Web Service"

3. Connect your GitHub repository

4. Configure the service:

   • Name: viincci-rag-mcp (or your preferred name)
   • Environment: Python 3
   • Build Command: pip install -r requirements.txt
   • Start Command: python server.py
   • Port: 8000 (Render will set the PORT environment variable automatically)

5. Click "Create Web Service"

Environment Variables (Optional)

If you need to use Render's dynamic port, update the server.py to use:

import os
port = int(os.environ.get("PORT", 8000))
mcp.run(transport="http", host="0.0.0.0", port=port)

But the current configuration should work fine as is.

Access Your Server

Once deployed, your MCP server will be available at:

https://your-service-name.onrender.com/mcp

Testing the Server

You can test the server by connecting an MCP client to the endpoint, or use curl:

# Health check
curl https://your-service-name.onrender.com/health

# Test the MCP endpoint (requires MCP client)
# Your MCP client should connect to: https://your-service-name.onrender.com/mcp

Server Details

• Tool Name: query
• Input: prompt (string) - any text input
• Output: Always returns the string "viincci_rag"

Usage in Claude Desktop or MCP Client

Add this configuration to your MCP client:

{
  "mcpServers": {
    "viincci_rag": {
      "url": "https://your-service-name.onrender.com/mcp",
      "transport": "http"
    }
  }
}

License

MIT