mcp
MCP server and client with Groq-powered CLI chat
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/sivaramakrishnag--mcp)HTML
<a href="/listings/sivaramakrishnag--mcp"><img src="/api/listings/sivaramakrishnag--mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Step 1: Configure the environment variables
1. Create or edit the `.env` file in the project root and verify that the following variables are set correctly:
GROQ_API_KEY="" # Enter your Groq API key GROQ_MODEL="llama-3.3-70b-versatile"
Step 2: Install dependencies
Option 1: Setup with uv (Recommended)
[uv](https://github.com/astral-sh/uv) is a fast Python package installer and resolver.
1. Install uv, if not already installed:
pip install uv
2. Create and activate a virtual environment:
uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
3. Install dependencies:
uv pip install -e .
4. Run the project
uv run main.py
Option 2: Setup without uv
1. Create and activate a virtual environment:
python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
2. Install dependencies:
pip install groq python-dotenv prompt-toolkit "mcp[cli]==1.8.0"
3. Run the project
python main.py
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 112 lines
- # MCP Chat
- MCP Chat is a command-line interface application that enables interactive chat capabilities with Groq models. The application supports document retrieval, command-based prompts, and extensible tool integrations via the MCP (Model Context Protocol) architecture.
- ## Prerequisites
- - Python 3.9+
- - Groq API key
- ## Setup
- ### Step 1: Configure the environment variables
- 1. Create or edit the `.env` file in the project root and verify that the following variables are set correctly:
- ```
- GROQ_API_KEY="" # Enter your Groq API key
- GROQ_MODEL="llama-3.3-70b-versatile"
- ```
- ### Step 2: Install dependencies
- #### Option 1: Setup with uv (Recommended)
- [uv](https://github.com/astral-sh/uv) is a fast Python package installer and resolver.
- 1. Install uv, if not already installed:
- ```bash
- pip install uv
- ```
- 2. Create and activate a virtual environment:
- ```bash
- uv venv
- source .venv/bin/activate # On Windows: .venv\Scripts\activate
- ```
- 3. Install dependencies:
- ```bash
- uv pip install -e .
- ```
- 4. Run the project
- ```bash
- uv run main.py
- ```
- #### Option 2: Setup without uv
- 1. Create and activate a virtual environment:
- ```bash
- python -m venv .venv
- source .venv/bin/activate # On Windows: .venv\Scripts\activate
- ```
- 2. Install dependencies:
- ```bash
- pip install groq python-dotenv prompt-toolkit "mcp[cli]==1.8.0"
- ```
- 3. Run the project
- ```bash
- python main.py
- ```
- ## Usage
- ### Basic Interaction
- Simply type your message and press Enter to chat with the model.
- ### Document Retrieval
- Use the @ symbol followed by a document ID to include document content in your query:
- ```
- > Tell me about @deposition.md
- ```
- ### Commands
- Use the / prefix to execute commands defined in the MCP server:
- ```
- > /summarize deposition.md
- ```
- Commands will auto-complete when you press Tab.
- ## Development
- ### Adding New Documents
- Edit the `mcp_server.py` file to add new documents to the `docs` dictionary.
- ### Implementing MCP Features
- To fully implement the MCP features:
- 1. Complete the TODOs in `mcp_server.py`
- 2. Implement the missing functionality in `mcp_client.py`
- ### Linting and Typing Check
- There are no lint or type checks implemented.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.