IBHack MCP Server

A Model Context Protocol (MCP) server that provides intelligent tool discovery and recommendation capabilities using Google Gemini AI. The server can scan Python directories for tool classes and recommend the most relevant tools based on user queries.

Features

Tool Discovery: Automatically scans Python directories to discover tool classes
AI-Powered Recommendations: Uses Google Gemini to recommend the most relevant tools based on user queries
HTTP Transport: Runs as an HTTP server for easy integration
Complete Code Generation: Returns full Python code for recommended tools

Environment Variables

The following environment variables need to be set to run the MCP server:

Required

GEMINI_API_KEY: Your Google AI API key for Gemini integration
- Example: export GEMINI_API_KEY="your-api-key-here"

Optional

SCAN_DIRECTORY: Directory path to scan for tools during startup
- Example: export SCAN_DIRECTORY="/path/to/your/tools"

Installation

Install Poetry (if not already installed):
curl -sSL https://install.python-poetry.org | python3 -
Install dependencies:
poetry install
Set environment variables:
export GEMINI_API_KEY="your-api-key-here" export SCAN_DIRECTORY="/path/to/your/tools" # Optional

Running the Server

Method 1: Direct Python execution

python server.py

Method 2: Using Poetry

poetry run python server.py

Method 3: Using the Poetry script

poetry run mcp-server

The server will start on http://127.0.0.1:8000/mcp by default.

Configuration

Server Configuration

The server runs with the following default settings:

Host: 127.0.0.1
Port: 8000
Path: /mcp
Transport: HTTP

To modify these settings, edit the mcp.run() call in server.py:

mcp.run(transport="http", host="127.0.0.1", port=8000, path="/mcp")

Tool Discovery

The server looks for Python classes that:

Have methods: get_name(), get_description(), and execute()
Are located in .py files within the specified directory
Can optionally have get_input_schema() and get_output_schema() methods

Available Tools

`recommend_tools`

Finds the most relevant tools for a given description using Gemini AI.

Parameters:

query_description (string): Description of what the user wants to do
top_k (integer, optional): Number of top tools to return (default: 2)

Returns:

Dictionary containing recommended tools with complete Python code
Success status and error information
Tool metadata (name, description, file path, class name)

Example Usage

Using the Client

import asyncio from client import MCPClientInterface async def main(): client = MCPClientInterface("http://127.0.0.1:8000/mcp") # Connect to server await client.connect() # Get tool recommendations result = await client.execute_tool( "recommend_tools", query_description="I need to process CSV data", top_k=3 ) print(result) await client.disconnect() asyncio.run(main())

Direct HTTP Request

curl -X POST http://127.0.0.1:8000/mcp \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "recommend_tools", "arguments": { "query_description": "I need to analyze data", "top_k": 2 } } }'

This server cannot be installed

-

security - not tested

-

license - not tested

-

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables intelligent discovery and recommendation of Python tools using Google Gemini AI. Automatically scans directories for tool classes and recommends the most relevant tools based on user queries with complete code generation.

IBHack MCP Server

IBHack MCP Server

Features

Environment Variables

Required

Optional

Installation

Running the Server

Method 1: Direct Python execution

Method 2: Using Poetry

Method 3: Using the Poetry script

Configuration

Server Configuration

Tool Discovery

Available Tools

`recommend_tools`

Example Usage

Using the Client

Direct HTTP Request

New MCP Servers

MCP directory API