MCP.so
Sign In

Building a Watsonx.ai Chatbot RAG Server with MCP

@ruslanmv

Repository

About Building a Watsonx.ai Chatbot RAG Server with MCP

Building a Watsonx.ai Chatbot RAG Server with MCP compatible with Claude Desktop.

Basic information

Category

Memory & Knowledge

Runtime

python

Transports

stdio

Publisher

ruslanmv

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "watsonx-rag-mcp-server": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        ".venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Building a Watsonx.ai Chatbot RAG Server with MCP?

A Retrieval-Augmented Generation (RAG) server that uses IBM Watsonx.ai for LLM inference, ChromaDB for vector indexing, and exposes a chat tool via the Model Context Protocol (MCP) Python SDK. It processes PDF documents and answers queries based on their content, and can integrate with Claude Desktop.

How to use Building a Watsonx.ai Chatbot RAG Server with MCP?

Set up a Python 3.8+ virtual environment, install dependencies, create a .env file with Watsonx.ai credentials, place PDF files in the documents/ folder, then run server.py to start the MCP server. A client.py script is provided for testing queries, and the server can also be plugged into Claude Desktop.

Key features of Building a Watsonx.ai Chatbot RAG Server with MCP

  • Uses IBM Watsonx.ai for large language model inference
  • Indexes PDF documents in ChromaDB vector database
  • Exposes a single MCP tool (chat_with_manual) for RAG queries
  • Supports configurable chunk size and overlap for text splitting
  • Integrates directly with Claude Desktop via MCP

Use cases of Building a Watsonx.ai Chatbot RAG Server with MCP

  • Answering questions from technical manuals (e.g., drone documentation)
  • Building a chatbot grounded in a company’s internal PDF documents
  • Enabling Claude Desktop to retrieve information from local PDF files
  • Rapid prototyping of a RAG pipeline without custom infrastructure

FAQ from Building a Watsonx.ai Chatbot RAG Server with MCP

What are the runtime requirements?

Python 3.8+ and an IBM Cloud account with provisioned Watsonx.ai services. You need a Watsonx API key and project ID.

Where are the documents and vector data stored?

PDFs are kept in the local documents/ folder (configurable via DOCS_FOLDER). The ChromaDB vector index persists to the chroma_db_data/ directory.

How does the RAG process work?

When a user asks a question, the server retrieves relevant text chunks from ChromaDB, concatenates them with the query, and sends the combined prompt to Watsonx.ai for answer generation.

What transport does the MCP server use?

The server is built with FastMCP, which defaults to stdio transport; it is configured to work with Claude Desktop’s MCP integration.

Is authentication required?

Yes, the server reads WATSONX_APIKEY, WATSONX_URL, and PROJECT_ID from a .env file and validates them at startup.

Comments

More Memory & Knowledge MCP servers

mcp-local-rag

nkapila6

"primitive" RAG-like web search model context protocol (MCP) server that runs locally. ✨ no APIs ✨

128

Anytype MCP Server

anyproto

An MCP server enabling AI assistants to interact with Anytype - your encrypted, local and collaborative wiki - to organize objects, lists, and more through natural language.

467

📓 GistPad MCP

lostintangent

📓 An MCP server for managing your personal knowledge, daily notes, and re-usable prompts via GitHub Gists

199

MCP Apple Notes

RafalWilinski

Talk with your notes in Claude. RAG over your Apple Notes using Model Context Protocol.

401

Ultimate Google Docs & Drive MCP Server

a-bonus

The Ultimate Google Docs, Sheets, Drive, Gmail, & Google Calendar MCP Server. This MCP (primarily for use in Claude Desktop) gains full access to your google suite and lets claude do its thing.

605