You.com Web Access & AI

@youdotcom-oss/mcp

用于托管 You.com MCP 服务的纯二进制 STDIO 桥接程序，服务地址为 https://api.you.com/mcp。

此软件包不会在本地注册工具，也不包含 REST 工具逻辑。它唯一的用途是将 STDIO MCP 流量代理到托管的远程服务。

快速开始

// Add this to your MCP client config (Claude Desktop, Cursor, Windsurf, etc.)
// Free tier — no API key, no signup.
{
  "mcpServers": {
    "you": {
      "command": "npx",
      "args": ["@youdotcom-oss/mcp"],
      "env": { "YDC_PROFILE": "free" }
    }
  }
}

如果你的客户端支持远程 MCP，可直接连接 https://api.you.com/mcp?profile=free，无需运行本地进程。

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "you": {
      "command": "npx",
      "args": ["@youdotcom-oss/mcp"],
      "env": { "YDC_PROFILE": "free" }
    }
  }
}

已认证（所有默认工具）：

{
  "mcpServers": {
    "you": {
      "command": "npx",
      "args": ["@youdotcom-oss/mcp"],
      "env": { "YDC_API_KEY": "<your-key>" }
    }
  }
}

Claude Code

# Free tier
claude mcp add you -e YDC_PROFILE=free -- npx @youdotcom-oss/mcp

# Authenticated
claude mcp add you -e YDC_API_KEY=<your-key> -- npx @youdotcom-oss/mcp

Cursor

添加到 ~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）：

{
  "mcpServers": {
    "you": {
      "command": "npx",
      "args": ["@youdotcom-oss/mcp"],
      "env": { "YDC_PROFILE": "free" }
    }
  }
}

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "you": {
      "command": "npx",
      "args": ["@youdotcom-oss/mcp"],
      "env": { "YDC_PROFILE": "free" }
    }
  }
}

VS Code

添加到用户或工作区的 mcp.json：

{
  "servers": {
    "you": {
      "command": "npx",
      "args": ["@youdotcom-oss/mcp"],
      "env": { "YDC_PROFILE": "free" }
    }
  }
}

任意 MCP 客户端（远程）

如果你的客户端支持可流式传输的 HTTP，可跳过本地桥接：

https://api.you.com/mcp?profile=free

已认证：

https://api.you.com/mcp
Authorization: Bearer <your-key>

安装

bun add @youdotcom-oss/mcp

或者直接运行：

npx @youdotcom-oss/mcp

环境变量

• YDC_API_KEY 可选。以 Authorization: Bearer <key> 形式发送。
• YDC_PROFILE 可选。设置为 free 时，会将桥接程序路由到 https://api.you.com/mcp?profile=free。
• YDC_ALLOWED_TOOLS 可选。以逗号分隔要通过 https://api.you.com/mcp?tools=... 暴露的托管工具 ID。

YDC_PROFILE 的优先级高于 YDC_ALLOWED_TOOLS。

工具暴露

默认的托管 MCP URL 会暴露四个工具：

• you-search
• you-contents
• you-balance
• you-discover

另有两个工具可按需使用：

• you-finance
• you-research

使用 tools 显式请求其他工具。tools 用于限定可见工具集。

目前，profile=free 是一种无需密钥的模式。它会覆盖 tools，并暴露 you-search 和 you-discover。

示例：

• 默认工具集：https://api.you.com/mcp
• 仅财务：https://api.you.com/mcp?tools=you-finance
• 搜索和财务：https://api.you.com/mcp?tools=you-search,you-finance
• 仅研究：https://api.you.com/mcp?tools=you-research
• 免费配置（无需密钥）：https://api.you.com/mcp?profile=free

链接

• API 密钥：you.com/platform/api-keys
• 平台文档：documentation.you.com
• MCP 注册表条目：io.github.youdotcom-oss/mcp
• 问题：github.com/youdotcom-oss/mcp/issues
• 支持：[email protected]

参与贡献

开发环境设置和代码规范见 AGENTS.md；贡献流程和 PR 规范见 CONTRIBUTING.md。欢迎提交问题和 PR。

许可证

MIT — 详见 LICENSE。