Skip to content

[Integration] opensumi/core - You.com MCP tool integration for AI-Native IDE #161

Description

@mouse-value-add

Target Repository URL

https://github.com/opensumi/core

Why this repo was selected

  • Perfect star range: 3,649 stars (ideal mid-popular project where PRs can realistically land)
  • Excellent recent activity: Last commit 2026-07-24, very active development
  • Outstanding search integration fit: AI-Native IDE framework that ALREADY supports MCP (Model Context Protocol) - perfect natural fit for adding You.com as MCP tools
  • TypeScript with modern architecture: Well-structured codebase with clear MCP integration patterns and comprehensive documentation
  • Clear integration path: Already has MCP client support, so adding You.com MCP tools fits the existing architecture perfectly
  • Active maintenance: Active community with clear contribution guidelines and responsive maintainers

Candidate evaluation summary

  • opensumi/core: SELECTED - AI-Native IDE framework with existing MCP client architecture and active development
  • NVlabs/ToolOrchestra: 753 stars, tool orchestration framework - good fit but less recent activity (last commit March)
  • owtf/owtf: 1,948 stars, offensive web testing framework - good but less direct search integration fit

Proposed integration type

You.com MCP server integration following existing MCP client patterns in opensumi/core

Planned env vars and setup

  • Optional YDC_API_KEY for authenticated You.com Search API access
  • Falls back to keyless You.com Search API (100 free searches/day) when not provided
  • Integration follows existing MCP client patterns in the opensumi/core codebase
  • MCP tools can be enabled/disabled in IDE configuration
  • No default behavior changes - You.com tools are opt-in via MCP configuration

Expected usage example

JSON Configuration:
{
"ai.native.mcp.servers": [
{
"name": "youcom-web",
"type": "sse",
"command": "https://api.you.com/mcp",
"env": { "YDC_API_KEY": "your-api-key" }
}
]
}

TypeScript Usage:
// Search for current information
const results = await mcpClient.callTool('you-search', {
query: 'TypeScript AI frameworks',
count: 10
});

// Extract URL content
const content = await mcpClient.callTool('you-contents', {
url: 'https://docs.example.com/api'
});

Validation performed

✅ TypeScript compilation and linting passes
✅ JSON configuration files validated
✅ Documentation follows existing MCP patterns in opensumi/core
✅ Integration leverages existing MCP client architecture
✅ Multiple deployment options: npm package and hosted SSE server
✅ Both keyless and authenticated operation modes documented
✅ Error scenarios handled gracefully with actionable guidance
✅ Backward compatibility maintained - existing functionality unchanged
✅ Follows all established MCP integration patterns and architecture

Links

Integration type implemented

You.com MCP server integration as external MCP server option in AI-Native IDE

Setup/env vars

  • YDC_API_KEY: Optional API key for authenticated You.com Search API access
    • Without key: Uses keyless operation (100 free searches/day per IP)
    • With key: Higher quotas and enhanced features per You.com plan
  • Integration uses ai.native.mcp.servers configuration - opt-in via MCP setup
  • Server types: stdio (npm package) or sse (hosted server at https://api.you.com/mcp)

Usage example

Configuration (ai.native.mcp.servers):
{
"name": "youcom-web",
"type": "sse",
"command": "https://api.you.com/mcp",
"env": { "YDC_API_KEY": "your-key" }
}

Developer workflow:

  1. Configure You.com MCP server in IDE settings
  2. AI assistant gains web search capabilities
  3. Ask: "Search for latest React 19 features"
  4. AI uses you-search tool to get current information
  5. Receives cited, up-to-date responses

Fallback/error behavior

  • Missing API key: Uses keyless You.com MCP server operation automatically
  • Rate limits (429): Clear error suggesting API key upgrade with guidance
  • Invalid API key (401): Informative error about checking YDC_API_KEY variable
  • Network failures: Graceful error handling with context
  • MCP server unavailable: IDE functions normally, tools show unavailable status
  • All errors maintain IDE functionality and provide actionable guidance

Current status

Implementation complete and PR opened. The integration demonstrates opensumi/core's excellent MCP extensibility while providing immediate web search value for AI-Native IDE users. Documentation includes comprehensive setup guides, usage examples, and error handling. Awaiting upstream review from the opensumi team.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions