Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/sivaramakrishnag--mcp/badge.svg)](/listings/sivaramakrishnag--mcp)

HTML

<a href="/listings/sivaramakrishnag--mcp"><img src="/api/listings/sivaramakrishnag--mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

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
  1. # MCP Chat
  2. 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.
  3. ## Prerequisites
  4. - Python 3.9+
  5. - Groq API key
  6. ## Setup
  7. ### Step 1: Configure the environment variables
  8. 1. Create or edit the `.env` file in the project root and verify that the following variables are set correctly:
  9. ```
  10. GROQ_API_KEY="" # Enter your Groq API key
  11. GROQ_MODEL="llama-3.3-70b-versatile"
  12. ```
  13. ### Step 2: Install dependencies
  14. #### Option 1: Setup with uv (Recommended)
  15. [uv](https://github.com/astral-sh/uv) is a fast Python package installer and resolver.
  16. 1. Install uv, if not already installed:
  17. ```bash
  18. pip install uv
  19. ```
  20. 2. Create and activate a virtual environment:
  21. ```bash
  22. uv venv
  23. source .venv/bin/activate # On Windows: .venv\Scripts\activate
  24. ```
  25. 3. Install dependencies:
  26. ```bash
  27. uv pip install -e .
  28. ```
  29. 4. Run the project
  30. ```bash
  31. uv run main.py
  32. ```
  33. #### Option 2: Setup without uv
  34. 1. Create and activate a virtual environment:
  35. ```bash
  36. python -m venv .venv
  37. source .venv/bin/activate # On Windows: .venv\Scripts\activate
  38. ```
  39. 2. Install dependencies:
  40. ```bash
  41. pip install groq python-dotenv prompt-toolkit "mcp[cli]==1.8.0"
  42. ```
  43. 3. Run the project
  44. ```bash
  45. python main.py
  46. ```
  47. ## Usage
  48. ### Basic Interaction
  49. Simply type your message and press Enter to chat with the model.
  50. ### Document Retrieval
  51. Use the @ symbol followed by a document ID to include document content in your query:
  52. ```
  53. > Tell me about @deposition.md
  54. ```
  55. ### Commands
  56. Use the / prefix to execute commands defined in the MCP server:
  57. ```
  58. > /summarize deposition.md
  59. ```
  60. Commands will auto-complete when you press Tab.
  61. ## Development
  62. ### Adding New Documents
  63. Edit the `mcp_server.py` file to add new documents to the `docs` dictionary.
  64. ### Implementing MCP Features
  65. To fully implement the MCP features:
  66. 1. Complete the TODOs in `mcp_server.py`
  67. 2. Implement the missing functionality in `mcp_client.py`
  68. ### Linting and Typing Check
  69. There are no lint or type checks implemented.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.