About Groq Mcp Client
Groq Mcp Client is a CLI chat client that uses GroqCloud inference and connects to configured local and remote MCP servers. It lets users chat through a model while supplying server connections through a JSON configuration file.
Key features
- 01Use GroqCloud inference for chat
- 02Configure local stdio servers
- 03Configure remote SSE servers
- 04Set the model and API key in .env
Use cases
- 01Chat while consulting a local MCP server
- 02Use remote SSE servers in a chat session
MCP support
Acts as an MCP client, connecting to local stdio servers and remote SSE servers listed in server_config.json.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEInstallation
-
Clone the repository:
git clone <repository-url> cd groqcloud-mcp-client -
Create virtual environment and activate it:
uv venv # Creates .venv directory source .venv/bin/activate # Linux/Mac # or .\.venv\Scripts\activate on WindowsIf you don't have uv, you can follow these steps and install it.
-
Install dependencies (uv will read from pyproject.toml and uv.lock):
uv pip install -e . # For editable install # or uv pip install . # For regular install -
Add .env file:
GROQ_API_KEY='gsk_**' CLIENT_MODEL='deepseek-r1-distill-llama-70b'You can obtain the GROQ_API_KEY from https://console.groq.com/keys after you login.
Usage
- activate venv:
source .venv/bin/activate
- Update the
server_config.jsonwith required MCP servers.
Example:
{
"stdio_servers": [
"/home/dell/Documents/mcp/weather/weather.py"
],
"sse_servers": [
"https://btc.maratech.com/",
"https://insurancemcpserver.up.railway.app/"
]
}
- stdio_servers are the servers that are available locally. Leave the list empty if you don't have any. You can follow the MCP server docs to create a local MCP server
- Explore active SSE servers registered at https://ui.nanda-registry.com/explorer
- Run the CLI chat tool:
python src/main.py
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.