Integrated Search MCP Server

What is Integrated Search MCP Server?

A Model Context Protocol (MCP) server that integrates Google Custom Search API and Redmine API, enabling AI assistants to search the web and manage Redmine projects through a single interface. It is built for developers and teams who need to combine web search capabilities with Redmine issue and project management in an AI-driven workflow.

How to use Integrated Search MCP Server?

Install via git clone, npm install, and configure environment variables (GOOGLE_API_KEY, GOOGLE_SEARCH_ENGINE_ID, optionally REDMINE_URL and REDMINE_API_KEY). Build with npm run build, then add the server to an MCP client (e.g., Claude Desktop) by specifying node and the path to build/index.js with the environment variables. The server exposes six tools: google_search, google_search_images, redmine_list_issues, redmine_create_issue, redmine_list_projects, and redmine_get_issue.

Key features of Integrated Search MCP Server

• Web search via Google Custom Search API
• Image search with advanced filtering (size, type, safe search)
• Redmine issue listing, creation, and detailed viewing
• Redmine project browsing with pagination
• Support for language restrictions, site‑specific searches, and file type filtering
• Robust error handling and input validation using Zod schemas

Use cases of Integrated Search MCP Server

• Search the web or find images directly from an AI assistant conversation
• List, filter, and create Redmine issues without leaving the chat interface
• Browse Redmine projects and retrieve full issue details including custom fields
• Combine Google Search results with Redmine data for contextual decision making
• Quickly file bug reports or feature requests by specifying project, priority, and assignee

FAQ from Integrated Search MCP Server

What are the API limits for Google Custom Search and Redmine?

Google Custom Search API allows 100 free queries per day (up to 10,000 with billing) and returns up to 10 results per request. Redmine API limits depend on your Redmine instance configuration; most instances have no built‑in rate limits.

Is Redmine configuration required to use the server?

No. Redmine configuration is optional. If REDMINE_URL and REDMINE_API_KEY are not set, only Google Search functionality (web and image search) will be available.

What tools does the server provide?

The server provides six tools: google_search, google_search_images, redmine_list_issues, redmine_create_issue, redmine_list_projects, and redmine_get_issue. Each accepts specific parameters for filtering, pagination, and sorting.

How do I set up the Google Custom Search API?

Obtain a Google API key from the Google Cloud Console, enable the Custom Search API, and create a Custom Search Engine (CSE) at cse.google.com. Use the API key and CSE ID as GOOGLE_API_KEY and GOOGLE_SEARCH_ENGINE_ID environment variables.

How do I set up the Redmine API?

Log in to your Redmine instance, go to "My account", and reveal or generate an API access key. Set REDMINE_URL to your instance URL and REDMINE_API_KEY to the key.