sciverse-mcp-server 0.11.2 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,4 +1,4 @@
1
- export declare const TOOLS_VERSION = "0.11.2";
1
+ export declare const TOOLS_VERSION = "0.13.0";
2
2
  export interface ToolDef {
3
3
  name: string;
4
4
  description: string;
@@ -1,6 +1,6 @@
1
1
  // Auto-generated by scripts/gen-tools.mjs. Do not edit.
2
2
  // Source of truth: openapi.yaml
3
- export const TOOLS_VERSION = "0.11.2";
3
+ export const TOOLS_VERSION = "0.13.0";
4
4
  export const TOOLS = [
5
5
  {
6
6
  "name": "search_papers",
@@ -136,7 +136,27 @@ export const TOOLS = [
136
136
  "STRONG"
137
137
  ],
138
138
  "default": "NONE",
139
- "description": "模糊搜索新鲜度加权(仅 query 非空时生效;与 sort_by_year 互斥)。\nMILD: 近 10 年加权,适合日常查文献;STRONG: 近 3 年加权,适合跟踪\n研究方向 / 追最新进展。底层为 function_score + gauss decay over\npublication_published_date。\n"
139
+ "description": "模糊搜索新鲜度加权:结果偏向新文献(仅 query 非空时生效;传排序\n(sort_by_year 非 none / sort_advanced)时被忽略,硬排优先)。\nMILD: 近 10 年加权,适合日常查文献;STRONG: 近 3 年加权,适合跟踪\n研究方向 / 追最新进展。与 impact_boost / language_affinity 可叠加\n(均为乘法因子)。boost 生效时为浅翻页:不产 next_cursor、不支持\ncursor 深翻页。\n"
140
+ },
141
+ "impact_boost": {
142
+ "type": "string",
143
+ "enum": [
144
+ "NONE",
145
+ "MILD",
146
+ "STRONG"
147
+ ],
148
+ "default": "NONE",
149
+ "description": "模糊搜索影响力加权:高被引文献在保留相关性的前提下上浮(仅 query\n非空时生效;传排序时被忽略)。MILD: 轻度上浮,相关性仍主导;\nSTRONG: 明显偏向高被引。引用因子有界、零被引中性(不会归零)。\n与 freshness_boost / language_affinity 可叠加;boost 生效时为浅翻页。\n"
150
+ },
151
+ "language_affinity": {
152
+ "type": "string",
153
+ "enum": [
154
+ "NONE",
155
+ "MILD",
156
+ "STRONG"
157
+ ],
158
+ "default": "NONE",
159
+ "description": "模糊搜索语言亲和加权:非 query 语言的结果降序、但不排除(仅 query\n非空时生效;传排序时被忽略)。目标语言由服务端从 query 文本判定\n(假名→ja / 谚文→ko / 汉字→zh / 拉丁→en,其他书写系统不生效);\n语言未知的文献保持中性不降权。MILD: 非目标语言 ×0.5,跨语言强相关\n结果仍可上浮;STRONG: ×0.2,几乎只看目标语言。与 freshness_boost /\nimpact_boost 可叠加;boost 生效时为浅翻页。要硬排除某语言请改用\nfilters_advanced 的 language 字段(如 {\"field\":\"language\",\"value\":\"en\"},\n软硬两层语义不同:本参数只调序,filter 直接排除)。\n"
140
160
  },
141
161
  "page": {
142
162
  "type": "integer",
@@ -184,6 +204,48 @@ export const TOOLS = [
184
204
  ]
185
205
  }
186
206
  },
207
+ "filters": {
208
+ "type": "object",
209
+ "description": "结构化过滤(可选)。在召回阶段与语义检索同时生效(ES+Milvus 双引擎下推,\n不是结果后过滤);多个字段之间 AND,同一字段传数组时数组内 OR。\n⚠️ 宽松(软)语义:chunk 侧元数据缺失的文档不会被排除——例如按年份过滤时,\n缺年份信息的 chunk 仍可能返回。需要严格范围保证时勿当硬约束使用,\n表述结论时注明范围为\"近似过滤\"。\n数值/日期字段支持区间:{\"gte\":2020,\"lte\":2025} 或 [min,max](null 表示一侧不限);\n日期接受 YYYY / YYYY-MM / YYYY-MM-DD。\n实际可用字段受账号字段权限约束;未知字段服务端返回 400。\n例:{\"author\":[\"Hinton\"],\"publication_published_year\":{\"gte\":2023},\n \"topics\":{\"dimensions\":{\"primary_topic_domain\":\"Health Sciences\"}}}\n",
210
+ "properties": {
211
+ "lang": {
212
+ "description": "语言代码,如 \"en\"、\"zh\";也接受别名 language。"
213
+ },
214
+ "metadata_type": {
215
+ "description": "资源类型,仅单值:\"paper\" 或 \"ebook\"。"
216
+ },
217
+ "author": {
218
+ "description": "作者名,string 或 string[](数组=任一命中)。"
219
+ },
220
+ "publication_venue_name_unified": {
221
+ "description": "发表载体名称(期刊/会议,规范化名,适合精确匹配)。"
222
+ },
223
+ "publication_venue_type": {
224
+ "description": "载体类型:\"journal\"、\"conference\"、\"repository\"、\"book series\"、\"ebook platform\"、\"metadata\"、\"raidRegistry\"、\"igsnCatalog\"、\"other\"(不区分大小写)。"
225
+ },
226
+ "publication_published_year": {
227
+ "description": "发表年份,单值或区间({\"gte\":..,\"lte\":..} / [min,max])。"
228
+ },
229
+ "publication_published_date": {
230
+ "description": "发表日期,\"YYYY[-MM[-DD]]\" 单值或区间。"
231
+ },
232
+ "citation_count": {
233
+ "description": "被引次数,单值或区间。"
234
+ },
235
+ "influential_citation_count": {
236
+ "description": "高影响力被引次数,单值或区间。"
237
+ },
238
+ "title": {
239
+ "description": "标题精确匹配(标题检索一般更适合 search_papers)。"
240
+ },
241
+ "topics": {
242
+ "description": "主题组合过滤:{\"logic\":\"and|or\",\"dimensions\":{\"primary_topic\":\"...\",\"primary_topic_domain\":\"Physical Sciences|Social Sciences|Health Sciences|Life Sciences\"}};logic 省略默认 or。"
243
+ },
244
+ "doc_id": {
245
+ "description": "唯一的硬约束字段(其余字段均为软语义):命中绝不越出给定集合。\n值为 64 位小写 hex sha256(即 search_papers 返回的 doc_id;仅有全文的论文才有),\nstring 或 string[],仅 eq/in。去重后上限默认 1000,超限返回 400 SCOPE_TOO_LARGE;\n显式传空数组返回 200 空 hits(候选集为空,不退化为全局检索)。\n典型用法:先 search_papers 圈定候选集合,再在集合内做受限语义检索。\n"
246
+ }
247
+ }
248
+ },
187
249
  "mode": {
188
250
  "type": "string",
189
251
  "enum": [
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sciverse-mcp-server",
3
- "version": "0.11.2",
3
+ "version": "0.13.0",
4
4
  "description": "Sciverse MCP server — exposes academic paper retrieval (search_papers / semantic_search / read_content) to MCP-compatible coding agents (Claude Code, Cursor, Codex CLI, Windsurf, ...).",
5
5
  "license": "Apache-2.0",
6
6
  "homepage": "https://github.com/opendatalab/Sciverse-Agent-Tools/tree/main/packages/mcp",