mcp-projects

Open-Source Projects Repo for MCP (Model Context Protocol).

Steps to install and run:

1. Clone this repo
2. Install the requirements

   pip install mcp fastapi uvicorn fastapi-mcp llama-index llama-index-embeddings-huggingface llama-index-llms-langchain langchain-mcp-adapters mcp-use
   

3. Make a .env file in the root folder with the following credentials:

   API_KEY=<IBM_cloud_API_Key>
   PROJECT_ID=<Watsonx_Project_id>
   IBM_CLOUD_URL=<IBM cloud url>
   
   MODEL_ID=<your watsonx.ai LLM id>
   
   TAVILY_API_KEY=<your Tavily api key for web search>
   
   or, use your own llm provider - its agnostic to the projects (few changes needs to be done though)
   

4. Experiment with different projects and files
   • make sure to run the mcp servers first and then only
   • run the clients

What is Model Context Protocol (MCP)?

At its core, MCP is a standardized way for applications to provide AI models with richer context about their environment, user preferences, and conversation history. Think of it as a smart, structured way to feed memory and context to AI systems.

The Problem MCP Solves

Current AI systems have limited "working memory" - they can only see a certain amount of conversation history at once (their "context window"). Imagine trying to have a conversation with someone who only remembers the last few exchanges:

• You: "Remember that project we discussed last week about optimizing the supply chain?"
• AI without good context: "I don't recall that specific discussion. Could you remind me of the details?"

This limitation forces users to constantly re-explain things, leading to frustrating interactions. MCP aims to solve this by creating a structured method for maintaining and accessing context.

Some Analogies

1. GPS Navigation

Traditional AI context management is like giving someone directions one turn at a time, without showing them the full map. If they forget a step, the journey breaks down.

MCP is like a GPS navigation system that:

• Knows your destination
• Remembers your preferred routes
• Adjusts based on real-time conditions
• Always knows exactly where you are in the journey

Read this medium article for comprehensive understanding of MCP: Understanding Model Context Protocol (MCP): A Layman’s Guide

Do make Pull Requests to contribute to this asset ✨