@hs-web-team/aims-genai-search-mcp

AIMS GenAI Search MCP

A Model Context Protocol (MCP) server for searching HubSpot content using AIMS GenAI search capabilities. This project provides a service that can be integrated with AI assistants to fetch relevant content from HubSpot when answering user queries.

Features

• MCP server implementation for AI assistant integration
• HubSpot content search API integration
• Support for both stdio (Claude) and SSE transport methods
• Express server for HTTP connections

Prerequisites

• Node.js >= 22.0.0
• npm

Installation

Clone the repository and install dependencies:

git clone <repository-url>
cd aims-genai-search-mcp
npm install

Configuration

The application uses environment variables for configuration. You can create a .env file in the project root with the following options:

APP_VERSION=0.1.0
NODE_ENV=development
PORT=7878
TRANSPORT=stdio

Available transport methods:

• stdio: For command-line integration (default)
• sse: For web integration

Usage

Starting the Server

For production:

npm start

For development with auto-reloading:

npm run dev

Using the MCP Tools

The server exposes the following MCP tool:

• search-hubspot-context: Search content in HubSpot
  • Parameters: query (string) - The search query

Development

Build the TypeScript code:

npm run build

Watch for changes during development:

npm run build:watch

Inspect MCP server:

npm run inspect

Docker

# Build the image
docker buildx build -t hubspot/genai-search-mcp .

# Run the container
docker run -i --rm --name genai-search-mcp hubspot/genai-search-mcp

Claude Desktop Configuration

If you have the current repository cloned in your local machine, you can configure Claude Desktop to use it by running building the project and then adding the following configuration:

{
  "mcpServers": {
    // ...
    "genai-search": {
      "command": "node",
      "args": ["/path/to/aims-genai-search-mcp/build/server.js"]
    }
  }
}

Alternatively you can use npx:

{
  "mcpServers": {
    // ...
    "genai-search": {
      "command": "npx",
      "args": ["@hs-web-team/aims-genai-search-mcp"]
    }
  }
}

Or Docker:

{
  "mcpServers": {
    // ...
    "genai-search": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--name",
        "genai-search-mcp",
        "hubspot/genai-search-mcp"
      ]
    }
  }
}