You.com Web Access & AI

@youdotcom-oss/mcp

ホスト型 You.com MCP サーバー（https://api.you.com/mcp）向けの、バイナリーのみの STDIO ブリッジです。

このパッケージはツールをローカルに登録せず、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 任意です。公開するホスト型ツール ID をカンマ区切りで指定します。接続先は https://api.you.com/mcp?tools=... です。

YDC_PROFILE は YDC_ALLOWED_TOOLS より優先されます。

ツールの公開

デフォルトのホスト型 MCP URL では、4 つのツールが公開されます。

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

リクエストに応じて、さらに 2 つのツールを利用できます。

• you-finance
• you-research

追加のツールを利用するには、tools で明示的にリクエストしてください。tools を指定すると、表示されるツールセットが限定されます。

現在、profile=free は API キー不要のモードです。tools の指定より優先され、you-search と you-discover が公開されます。

例：

• デフォルトのツールセット：https://api.you.com/mcp
• Finance のみ：https://api.you.com/mcp?tools=you-finance
• Search と Finance：https://api.you.com/mcp?tools=you-search,you-finance
• Research のみ：https://api.you.com/mcp?tools=you-research
• Free プロファイル（API キー不要）：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 に記載されています。Issue と PR を歓迎します。

ライセンス

MIT — LICENSE を参照してください。