MCPlex AI

v1.0.0โ€ขCoding Agentsโ€ขstable

๐— ๐—ผ๐—ฑ๐—ฒ๐—น ๐—–๐—ผ๐—ป๐˜๐—ฒ๐˜…๐˜ ๐—ฃ๐—ฟ๐—ผ๐˜๐—ผ๐—ฐ๐—ผ๐—น (๐— ๐—–๐—ฃ) ๐—•๐—ฎ๐˜€๐—ฒ๐—ฑ ๐—–๐—Ÿ๐—œ ๐—”๐—œ | ๐—ง๐—ผ๐—ผ๐—น ๐—œ๐—ป๐˜๐—ฒ๐—ด๐—ฟ๐—ฎ๐˜๐—ถ๐—ผ๐—ป | ๐—š๐—ฒ๐—บ๐—ถ๐—ป๐—ถ ๐Ÿฎ.๐Ÿฌ

ai-actionsgemini-apigithub-analyzergithub-apillm-terminal
Share:
9
Stars
0
Downloads
0
Weekly
0/5

What is MCPlex AI?

MCPlex AI is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ๐— ๐—ผ๐—ฑ๐—ฒ๐—น ๐—–๐—ผ๐—ป๐˜๐—ฒ๐˜…๐˜ ๐—ฃ๐—ฟ๐—ผ๐˜๐—ผ๐—ฐ๐—ผ๐—น (๐— ๐—–๐—ฃ) ๐—•๐—ฎ๐˜€๐—ฒ๐—ฑ ๐—–๐—Ÿ๐—œ ๐—”๐—œ | ๐—ง๐—ผ๐—ผ๐—น ๐—œ๐—ป๐˜๐—ฒ๐—ด๐—ฟ๐—ฎ๐˜๐—ถ๐—ผ๐—ป | ๐—š๐—ฒ๐—บ๐—ถ๐—ป๐—ถ ๐Ÿฎ.๐Ÿฌ

๐— ๐—ผ๐—ฑ๐—ฒ๐—น ๐—–๐—ผ๐—ป๐˜๐—ฒ๐˜…๐˜ ๐—ฃ๐—ฟ๐—ผ๐˜๐—ผ๐—ฐ๐—ผ๐—น (๐— ๐—–๐—ฃ) ๐—•๐—ฎ๐˜€๐—ฒ๐—ฑ ๐—–๐—Ÿ๐—œ ๐—”๐—œ | ๐—ง๐—ผ๐—ผ๐—น ๐—œ๐—ป๐˜๐—ฒ๐—ด๐—ฟ๐—ฎ๐˜๐—ถ๐—ผ๐—ป | ๐—š๐—ฒ๐—บ๐—ถ๐—ป๐—ถ ๐Ÿฎ.๐Ÿฌ

This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • ๐— ๐—ผ๐—ฑ๐—ฒ๐—น ๐—–๐—ผ๐—ป๐˜๐—ฒ๐˜…๐˜ ๐—ฃ๐—ฟ๐—ผ๐˜๐—ผ๐—ฐ๐—ผ๐—น (๐— ๐—–๐—ฃ) ๐—•๐—ฎ๐˜€๐—ฒ๐—ฑ ๐—–๐—Ÿ๐—œ ๐—”๐—œ | ๐—ง๐—ผ๐—ผ๐—น ๐—œ๐—ป๐˜๐—ฒ๐—ด๐—ฟ๐—ฎ๐˜๐—ถ๐—ผ๐—ป

Use Cases

Build CLI AI with MCP tool integration and Gemini 2.0.
Analyze GitHub repositories and execute terminal commands through AI.
Create LLM-powered terminal applications.
Ecolash

Maintainer

LicenseMIT
Languagejavascript
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcplex-ai-v1-0

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MCPlex AI

MCPlex AI v1.0 is a command-line AI assistant built on the Model Context Protocol with Gemini 2.0 as its reasoning engine. It ships an MCP server exposing tools for fetching news, posting to Twitter/X, searching Wikipedia, querying GitHub repository stats, looking up movie ratings via OMDB, searching local files, generating truth tables, and defining wordsโ€”all orchestrated through a conversational CLI client.

Prerequisites

  • Node.js v16 or later and npm v7 or later
  • A Google Gemini API key (GEMINI_API_KEY)
  • Twitter/X API credentials if you want to use the twitter-X-post tool
  • An OMDB API key for movie ratings (free tier available at omdbapi.com)
  • Git to clone the repository
1

Clone the repository

Download the MCPlex AI source code.

git clone https://github.com/Ecolash/MCPlex-AI-v1.0.git
cd MCPlex-AI-v1.0
2

Install server dependencies and configure server .env

Install the MCP server packages and create the server-side .env file with Twitter and OMDB credentials.

cd server
npm install

# Create server/.env
cat > .env << 'EOF'
TWITTER_API_KEY=your_twitter_api_key
TWITTER_API_SECRET=your_twitter_api_secret
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_SECRET=your_access_secret
OMDB_API_KEY=your_omdb_api_key
EOF
3

Start the MCP server

Launch the server process. It must be running before the client is started.

node index.js
4

Install client dependencies and configure client .env

In a new terminal, install the client packages and provide the Gemini API key.

cd client
npm install

# Create client/.env
cat > .env << 'EOF'
GEMINI_API_KEY=your_gemini_api_key
EOF
5

Start the CLI client

Launch the conversational client. It connects to the running MCP server and begins the interactive session.

node index.js

MCPlex AI Examples

Client configuration

Environment variable files for the server and client components. Store API keys in .env files which are git-ignored by default.

# server/.env
TWITTER_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxx
TWITTER_API_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxx
TWITTER_ACCESS_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxx
TWITTER_ACCESS_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxx
OMDB_API_KEY=xxxxxxxx

# client/.env
GEMINI_API_KEY=AIzaSy...

Prompts to try

Example natural language commands for the MCPlex AI CLI chatbot.

- "What are the latest headlines about artificial intelligence?"
- "Search Wikipedia for the history of the Model Context Protocol"
- "Get the GitHub stats for the repository torvalds/linux"
- "What is the IMDB rating and plot for the movie Interstellar?"
- "Generate a truth table for the expression (A AND B) OR (NOT C)"

Troubleshooting MCPlex AI

Client fails to connect to MCP server

The server (cd server && node index.js) must be running before you start the client. Both processes must be running simultaneously in separate terminals. Check that no firewall or port conflict is blocking the local connection.

twitter-X-post tool returns authentication error

All four Twitter credentials are required: API_KEY, API_SECRET, ACCESS_TOKEN, and ACCESS_SECRET. Generate them at developer.twitter.com under your app's Keys and Tokens section. Ensure your app has Read and Write permissions enabled.

GEMINI_API_KEY invalid or quota exceeded

Verify the key is correct at aistudio.google.com/apikey. Free tier has per-minute and per-day request limits. If quota is exceeded, wait for the reset window or upgrade to a paid Gemini API plan.

Frequently Asked Questions about MCPlex AI

What is MCPlex AI?

MCPlex AI is a Model Context Protocol (MCP) server that ๐— ๐—ผ๐—ฑ๐—ฒ๐—น ๐—–๐—ผ๐—ป๐˜๐—ฒ๐˜…๐˜ ๐—ฃ๐—ฟ๐—ผ๐˜๐—ผ๐—ฐ๐—ผ๐—น (๐— ๐—–๐—ฃ) ๐—•๐—ฎ๐˜€๐—ฒ๐—ฑ ๐—–๐—Ÿ๐—œ ๐—”๐—œ | ๐—ง๐—ผ๐—ผ๐—น ๐—œ๐—ป๐˜๐—ฒ๐—ด๐—ฟ๐—ฎ๐˜๐—ถ๐—ผ๐—ป | ๐—š๐—ฒ๐—บ๐—ถ๐—ป๐—ถ ๐Ÿฎ.๐Ÿฌ It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCPlex AI?

Follow the installation instructions on the MCPlex AI GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MCPlex AI?

MCPlex AI works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCPlex AI free to use?

Yes, MCPlex AI is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Coding Agents MCP Servers

Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcplex-ai-v1-0": { "command": "npx", "args": ["-y", "mcplex-ai-v1-0"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide โ†’

Ready to use MCPlex AI?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides