sofya-mcp
MCP server for Sofya - web search, fetch, extract, and deep research for AI agents, exposed over the Model Context Protocol.
接入你的智能体
發布者自己的 URL。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
https://mcp.sofya.co/mcp上方的 Claude 按鈕會開啟 Claude,並填好名稱和 URL。你仍需在那裡確認。
claude mcp add --transport http co.sofya-sofya https://mcp.sofya.co/mcpRun in a terminal.
{ "mcpServers": { "co.sofya-sofya": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.sofya.co/mcp" ] } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
MCP server for Sofya - web search, fetch, extract, and deep research for AI agents, exposed over the Model Context Protocol.
Web search, fetch, extract, and research for AI agents. Markdown output + AI-synthesized answers.
Use it either way:
https://sofya.co/mcp with your API key as a Bearer token. This is the server listed in the MCP registry as co.sofya/sofya.sofya-mcp package over stdio. It is a thin wrapper around the Sofya REST API with the same tools.All four tools are read-only. Eligible GitHub accounts get 2,000 free credits a month.
Get an API key at sofya.co (keys look like ay_live_...), then point your client at the hosted endpoint.
VS Code / GitHub Copilot (.vscode/mcp.json):
{
"servers": {
"sofya": {
"type": "http",
"url": "https://sofya.co/mcp",
"headers": { "Authorization": "Bearer ay_live_..." }
}
}
}
Claude Code:
claude mcp add --transport http sofya https://sofya.co/mcp --header "Authorization: Bearer ay_live_..."
Cursor (~/.cursor/mcp.json):
{
"mcpServers": {
"sofya": {
"url": "https://sofya.co/mcp",
"headers": { "Authorization": "Bearer ay_live_..." }
}
}
}
Then ask your agent things like "search for the latest Node.js LTS release notes", "fetch this PDF and summarize it", or "research how the EU AI Act treats open-weight models". Full API docs: sofya.co/docs.
ay_live_...)Run it directly with npx - no install needed:
SOFYA_API_KEY=ay_live_... npx -y sofya-mcp
claude mcp add sofya --env SOFYA_API_KEY=ay_live_... -- npx -y sofya-mcp
Add this to your MCP config (e.g. claude_desktop_config.json, or .cursor/mcp.json):
{
"mcpServers": {
"sofya": {
"command": "npx",
"args": ["-y", "sofya-mcp"],
"env": {
"SOFYA_API_KEY": "ay_live_..."
}
}
}
}
Add it with the Codex CLI:
codex mcp add sofya --env SOFYA_API_KEY=ay_live_... -- npx -y sofya-mcp
Or edit ~/.codex/config.toml directly. Note Codex puts environment variables in
a nested [mcp_servers.<name>.env] table:
[mcp_servers.sofya]
command = "npx"
args = ["-y", "sofya-mcp"]
[mcp_servers.sofya.env]
SOFYA_API_KEY = "ay_live_..."
Then run /mcp inside Codex to confirm the server is connected.
CLI flags --api-key and --base-url take precedence over the env vars.
Run npx sofya-mcp --list-tools to print the tool schemas, or --help for options.
git clone https://github.com/sofya-co/sofya-mcp.git
cd sofya-mcp
npm install # also builds via the prepare script
npm run build # compile TypeScript to build/
npm run watch # recompile on change
npm run inspector # debug with @modelcontextprotocol/inspector
The server is a single file, src/index.ts. Tool definitions
mirror Sofya's hosted MCP server exactly (same names, parameters, and defaults).
MIT - see LICENSE.
Web search, fetch, extract, and research for AI agents. Markdown output + AI-synthesized answers.
{ "mcpServers": { "co.sofya-sofya": { "url": "https://mcp.sofya.co/mcp", "headers": {} } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 http 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Sofya 透過 HTTP 存取。
上次檢查時間:2026-11-18。 Web search, fetch, extract, and research for AI agents. Markdown output + AI-synthesized answers.