The You.com MCP Server enables AI assistants to perform various types of searches and gather information using the You.com API:
Web Search: Access You.com's standard web search functionality
Smart Search: Get AI-powered answers with citation support and custom instructions
Research: Obtain comprehensive, citation-backed answers for academic queries
News Search: Fetch the latest news articles on any topic
Allows storing configuration and API keys for the You.com service in environment variables loaded from a .env file.
Used for cloning the repository during installation.
Hosts the repository (youcom-mcp) that can be cloned for installation.
Required runtime environment for the MCP server with version 16 or higher needed.
Package manager used to install dependencies and run the MCP server.
Alternative package manager that can be used instead of npm to install dependencies.
You.com MCP Server
This MCP (Model Context Protocol) server provides AI assistants with the ability to search the web, get news, and perform research using the You.com API. Feedback welcomed.
Features
Web Search: Access to You.com's web search functionality
Smart Search: AI-powered answers with citation support
Research: Comprehensive, citation-backed answers for academic queries
News Search: Latest news articles on any topic
Prerequisites
Node.js (v16 or higher)
npm or yarn
You.com API key (get one from api.you.com)
Installation
Clone this repository:
git clone https://github.com/jimbul/youcom-mcp.git cd youcom-mcpInstall dependencies:
npm installCreate a
.env
file based on the example:cp .env.example .envAdd your You.com API key to the
.env
file:YOU_API_KEY=your_actual_api_key_hereBuild the project:
npm run build
Running Locally (Optional)
You can run the server locally for testing:
Setting up with Claude
To use this MCP server with Claude (Anthropic Assistant), you need to configure Claude to use this server:
Open the Claude extension settings in VS Code:
Click on the Claude icon in the VS Code sidebar
Click on the settings icon (⚙️) and select "MCP Settings"
Add the following configuration to the
mcpServers
section:
Important Notes:
Replace
/absolute/path/to/your/youcom-mcp/dist/index.js
with the actual path on your systemReplace
your_actual_api_key_here
with your You.com API key
Usage Examples
Once configured, you can use the MCP tools directly in your conversations with Claude:
Web Search
Smart Search
Research
News Search
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Running evals
The evals package loads an mcp client that then runs the index.ts file, so there is no need to rebuild between tests. You can load environment variables by prefixing the npx command. Full documentation can be found here.
License
MIT
Acknowledgements
This project uses the You.com API for search functionality.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
MCP server that provides Claude AI assistants with the ability to search the web, get news, and perform research using the You.com API.
Related MCP Servers
- -securityAlicense-qualityAn MCP server that allows Claude and other AI assistants to interact with the YouTube API, providing tools to search videos/channels and retrieve detailed information about them.Last updated -31MIT License
- -securityFlicense-qualityAn MCP server that allows AI assistants like Claude to execute terminal commands on the user's computer and return the output, functioning like a terminal through AI.Last updated -57
- -securityFlicense-qualityAn MCP server that integrates with Claude to provide smart documentation search capabilities across multiple AI/ML libraries, allowing users to retrieve and process technical information through natural language queries.Last updated -
- AsecurityFlicenseAqualityMCP server that allows Claude AI to interact directly with MySQL databases, enabling query execution and table information retrieval through natural language.Last updated -144