MCP with RAG Demo

@thinklytics

代码仓库

基本信息

分类

记忆与知识

许可证

MIT license

传输方式

stdio

作者

thinklytics

关于 MCP with RAG Demo

This demonstration project shows how to implement a Model Context Protocol (MCP) server with Retrieval-Augmented Generation (RAG) capabilities. The demo allows AI models to interact with a knowledge base, search for information, and add new documents.

MCP with RAG Demo 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-demo-thinklytics": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "mcp-env"
      ]
    }
  }
}

MCP with RAG Demo 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is MCP with RAG Demo?

MCP with RAG Demo is an example implementation of a Model Context Protocol (MCP) server integrated with Retrieval-Augmented Generation (RAG) capabilities. It allows AI models to interact with a knowledge base, search for information, and add new documents. The project is intended for developers learning how to build MCP servers with RAG.

How to use MCP with RAG Demo?

Install dependencies with pip install -r requirements.txt, then start the MCP server in either SSE mode (python server.py --sse) or stdio mode (python server.py --stdio). Run the client example with python client_example.py --sse http://localhost:8000 for SSE or python client_example.py --stdio --command python --args "server.py --stdio" for stdio. An OpenAI integration example is also available via python openai_example.py after setting the OPENAI_API_KEY environment variable.

Key features of MCP with RAG Demo

MCP server with tool and resource support
RAG implementation with in-memory storage fallback
Client example for interacting with the MCP server
Support for both SSE (HTTP) and stdio communication modes
Simple prompt templates for greetings

Use cases of MCP with RAG Demo

Demonstrating how to build an MCP server with RAG capabilities
Adding documents to a knowledge base and searching them with AI
Testing MCP communication over SSE or stdio
Integrating OpenAI’s API with an MCP server

常见问题

What tools are available in MCP with RAG Demo?

The demo provides five tools: `echo`, `add`, `add_document`, `rag_search`, and `list_documents`. Each tool has a specific purpose, such as echoing messages or adding documents to the knowledge base.

What communication modes does the server support?

The server supports SSE (HTTP) mode using Server-Sent Events and stdio mode for standard input/output communication. Default SSE host is `0.0.0.0:8000`, customizable with `--host` and `--port`.

What are the runtime requirements?

Python 3.8+ and pip are required. Dependencies are listed in `requirements.txt` and include the `mcp-sdk` package. An OpenAI API key is needed for the OpenAI example.

Where does the knowledge base data live?

The knowledge base uses in-memory storage (no persistent database). Documents are held only while the server is running. Sample data is available from the `sample://data` resource.

How do I troubleshoot connection issues?

Ensure the server is running in another terminal, check the URL (default `http://localhost:8000`), and verify the server is listening on the expected interface. Use `--debug` for verbose output. The client automatically appends `/sse` if missing.

记忆与知识分类下的更多 MCP 服务器

LoreKeeper RPG (lorekeeper.com)

LoreKeeper Ltd

Mess in, magic out: pour in your D&D and TTRPG notes and LoreKeeper keeps them as a private store for your world. Ask Claude or ChatGPT about it, or build a sourcebook.