el-Badr07/github_mcp_server

MCP Multi-Tool Server

A comprehensive Model Context Protocol (MCP) server built with TypeScript that provides multiple tools for calculations, database queries, web search, and code execution.

✨ Features

🔧 Available Tools

1. Calculator (calculate) - Evaluates mathematical expressions safely
2. Database Query (query-database) - Executes read-only SQL queries on PostgreSQL
3. Web Search (web-search) - AI-powered web search using Tavily API
4. Code Execution (execute-code) - Runs JavaScript code in a sandboxed environment

📦 Installation

1. Clone the repository and install dependencies:

git clone <repository_url>
cd mcp_ts
npm install

2. Copy the example environment file and configure:

cp .env.example .env

3. Build the project:

npm run build

🚀 Usage

Environment Setup

Set up your environment variables for database access and API keys:

# Database configuration
export DB_HOST=localhost
export DB_PORT=5432
export DB_NAME=your_database
export DB_USER=your_username
export DB_PASSWORD=your_password

# Tavily API key for web search
export TAVILY_API_KEY=your_tavily_api_key

Running the Server

The server uses HTTP transport and listens on port 3000:

npm run start

The server will be available at http://localhost:3000/mcp

Testing with Automated Client

Run the comprehensive test suite:

npm run test

This will test all tools including:

• Mathematical calculations
• Web search with AI-powered results
• Code execution sandbox
• Database connectivity (if configured)

Interactive Testing

For manual testing and exploration:

npm run client

Interactive Commands