UniFuncs MCP Server

UniFuncs MCP 服务

UniFuncs API 的 MCP 服务——增强了深度搜索和深度研究功能

功能

此 MCP 服务可访问以下 UniFuncs API：

1. 网页搜索（web-search）

实时网页搜索，提供全面的结果

• 使用关键词搜索整个互联网
• 按时间范围筛选（Day/Week/Month/Year）
• 支持分页（每页 1-50 条结果）
• 多种输出格式（JSON/Markdown/Text）

2. 网页阅读器（web-reader）

提取网页的详细内容

• 提取清晰的内容
• 可选包含图片
• 支持链接摘要
• Markdown 输出

3. 深度搜索 - 同步（deep-search-sync）

实时深度搜索，立即返回结果

• 模型：S3 / S3 Pro
• 支持流式传输
• 即时响应

4. 深度搜索 - 异步（deep-search-create-task + deep-search-query-task）

针对复杂查询的异步深度搜索

• 创建任务并立即获取 task_id
• 轮询任务状态和结果
• 针对大型查询的后台处理

5. 深度研究（deep-research-create-task + deep-research-query-task）

全面的深度研究功能

• 模型：U3、U3 Pro
• 可自定义研究参数：
  • 引言：设置研究者角色
  • 参考文献样式：链接/数字/脚注
  • 最大深度：最多 50 次迭代（建议 25 次）
  • 域名范围：将搜索限制在特定域名
  • 域名黑名单：排除特定域名
  • 自定义输出提示词
  • 重要 URL、关键词和提示词
• 异步任务管理

设置

API 密钥

获取 UniFuncs API 密钥： https://unifuncs.com/account

NPX（STDIO）

{
    "mcpServers": {
        "unifuncs": {
            "command": "npx",
            "args": [
                "-y",
                "@unifuncs/ufn-mcp-server"
            ],
            "env": {
                "UNIFUNCS_API_KEY": "sk-**********"
            }
        }
    }
}

注意：npx 体验对应的是最新发布到 npm 的软件包，不一定是当前的 main 分支。如果 npm 上发布的版本落后于 main，请使用下方的源码构建说明，以获取最新合并的工具集。

源码构建（本地）

git clone https://github.com/UniFuncs/ufn-mcp-server.git
cd ufn-mcp-server
yarn install
npm run build
UNIFUNCS_API_KEY=sk-********** node build/index.js

Codex MCP 配置示例：

[mcp_servers.unifuncs-local]
command = "node"
args = ["/absolute/path/to/ufn-mcp-server/build/index.js"]

[mcp_servers.unifuncs-local.env]
UNIFUNCS_API_KEY = "sk-**********"

SSE 服务

对于 SSE 传输，请设置环境变量：

export UNIFUNCS_SSE_SERVER=true
export UNIFUNCS_SSE_SERVER_PORT=5656  # Optional, default is 5656

或者使用 --sse 标志：

npx @unifuncs/ufn-mcp-server --sse

工具参考

web-search

Query: Search keywords
Freshness: Day | Week | Month | Year (optional)
Page: Page number, default 1 (optional)
Count: Results per page, 1-50, default 10 (optional)
Format: json | markdown | text, default json (optional)

web-reader

URL: Page URL to read
Format: markdown (optional)
IncludeImages: boolean (optional)
LinkSummary: boolean (optional)

deep-search-sync

Model: s3 / s3-pro (default: s3)
Messages: Array of {role: "user"|"assistant"|"system", content: string}
Stream: boolean (default: false)

deep-search-create-task

Model: s3 / s3-pro (default: s3)
Messages: Array of {role: "user"|"assistant"|"system", content: string}
Returns: task_id for querying status

deep-search-query-task

Task_ID: Task ID from create_task
Returns: Task status, progress, and results when completed

deep-research-create-task

Model: u3 | u3-pro (default: u3)
Content: Research question/topic
Introduction: Researcher persona (optional)
Reference_Style: link | number | footnote (default: link)
Generate_Summary: boolean (default: false)
Max_Depth: 1-50 (default: 25, recommended)
Domain_Scope: Comma-separated domains (optional)
Domain_Blacklist: Comma-separated domains to exclude (optional)
Output_Prompt: Custom output template (optional)
Important_URLs: Comma-separated URLs (optional)
Important_Keywords: Comma-separated keywords (optional)
Important_Prompt: Important prompt content (optional)
Push_To_Share: boolean (default: false)
Set_Public: boolean (default: false)
Returns: task_id for querying status

deep-research-query-task

Task_ID: Task ID from create_task
Returns: Task status, progress, and results when completed

示例

网页搜索

{
  "query": "OpenClaw AI",
  "count": 5,
  "format": "json"
}

深度搜索（异步）

// Create task
{
  "model": "s3",
  "messages": [
    { "role": "user", "content": "What are the latest developments in AI?" }
  ]
}

// Query task (use returned task_id)
{
  "task_id": "3aff2a91-7795-4b73-8dab-0593551a27a1"
}

深度研究

// Create research task
{
  "model": "u3",
  "content": "Analyze the impact of AI on healthcare",
  "max_depth": 25,
  "domain_scope": "arxiv.org, nature.com",
  "generate_summary": true
}

// Query research task
{
  "task_id": "research-task-id-here"
}

定价

• 网页搜索：按请求计费
• 网页阅读器：按请求计费
• 深度搜索：按 Token 用量计费
• 深度研究：
  • U3：M Tokens
  • U3 Pro：M Tokens

详细定价请访问：https://unifuncs.com/pricing

支持

• 文档：https://unifuncs.com/api
• GitHub：https://github.com/UniFuncs/ufn-mcp-server
• 电子邮件：[email protected]
• 微信：unifuncs

维护者发布检查清单

在 npx 设置部分记录新工具之前，请确保 npm 软件包已发布并通过冒烟测试。

1. 提升软件包版本。
2. 安装依赖并运行 npm run build。
3. 将软件包发布到 npm。
4. 确认 npm view @unifuncs/ufn-mcp-server version 与预期发布版本一致。
5. 确认 npx -y @unifuncs/ufn-mcp-server 提供的工具与本 README 中描述的相同。
6. npm 发布版本可用后，更新变更日志和 README。

许可证

MIT

更新日志

v0.1.0（2026-02-25）

• 添加深度搜索同步 API 支持
• 添加深度搜索异步 API（create_task + query_task）
• 添加深度研究异步 API（create_task + query_task）
• 增补包含所有工具参考的文档
• 改进错误处理

v0.0.6

• 首次发布，包含 web-search 和 web-reader