@luffysolution/omnischolar-pi 0.1.1 → 0.1.3

package/host-configs/README.md

@@ -1,11 +1,11 @@
-# Agent configuration files
-
-- Portable Agent Plugin and Codex: root `plugin.json`, `mcp.json`, and `skills/`
-- Claude Code: `.claude-plugin/plugin.json`, root `.mcp.json`, and `skills/`
-- Cursor: root Agent Plugin files plus `.cursor-plugin/plugin.json`
-- OpenCode: merge `opencode.jsonc` into the project or user OpenCode config
-- Hermes: merge `hermes.yaml` into `~/.hermes/config.yaml`
+# Agent configuration files
+
+- Portable Agent Plugin and Codex: root `plugin.json`, `mcp.json`, and `skills/`
+- Claude Code: `.claude-plugin/plugin.json`, root `.mcp.json`, and `skills/`
+- Cursor: root Agent Plugin files plus `.cursor-plugin/plugin.json`
+- OpenCode: merge `opencode.jsonc` into the project or user OpenCode config
+- Hermes: merge `hermes.yaml` into `~/.hermes/config.yaml`
 - Pi: see `pi.md`; the npm Extension bridges the local MCP server
 - WorkBuddy/CodeBuddy: merge `workbuddy.json` into `~/.codebuddy/.mcp.json` or project `.mcp.json`
-
-All supported MCP entries start the local command `omnischolar mcp`. These files contain no provider credentials.
+
+All supported MCP entries start the local command `omnischolar mcp`. These files contain no provider credentials.

package/host-configs/hermes.yaml

@@ -1,5 +1,5 @@
-mcp_servers:
-  omnischolar:
+mcp_servers:
+  omnischolar:
     command: "omnischolar"
     args: ["mcp"]
     # Optional: restrict exposure with tools.include or tools.exclude.

package/host-configs/opencode.jsonc

@@ -1,11 +1,11 @@
-{
-  "$schema": "https://opencode.ai/config.json",
-  "mcp": {
-    "omnischolar": {
-      "type": "local",
-      "command": ["omnischolar", "mcp"],
-      "enabled": true,
-      "timeout": 10000
-    }
-  }
-}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "omnischolar": {
+      "type": "local",
+      "command": ["omnischolar", "mcp"],
+      "enabled": true,
+      "timeout": 10000
+    }
+  }
+}

package/host-configs/pi.md

@@ -1,5 +1,5 @@
-# Pi
-
+# Pi
+
 OmniScholar uses the npm-published `@luffysolution/omnischolar-pi` Extension to bridge its local MCP server into Pi. The full installer also copies Skills to `.pi/agent/skills` for user scope or `.pi/skills` for project scope.
 
 ```sh
@@ -8,6 +8,6 @@ omnischolar install pi
 pi install npm:@luffysolution/omnischolar-pi
 ```
 
-The Extension starts `omnischolar mcp`, discovers the server's tools, forwards calls and cancellation signals, and closes the MCP client when the Pi session ends.
+The Extension starts the matching PyPI MCP through `uvx`, discovers the server's tools, forwards calls and cancellation signals, and closes the MCP client when the Pi session ends. A separate global `omnischolar` command is not required; `uv` must be on `PATH`.
 
 `omnischolar mcp install pi` remains `manual_required` because Pi uses an Extension instead of a native MCP settings file. Use the full `omnischolar install pi` command.

package/omnischolar.config.example.json

@@ -1,214 +1,218 @@
-{
-  "schemaVersion": 1,
-  "runtime": {
-    "cacheDirectory": ".omnischolar/cache",
-    "python": "python",
-    "logLevel": "info",
-    "maxOutputBytes": 51200,
-    "maxOutputLines": 2000,
-    "maxResponseBytes": 16777216,
-    "requestTimeoutSeconds": 30,
-    "workspaceRoots": ["."]
-  },
-  "tools": {
-    "groups": {
-      "literature": true,
-      "ai4scholar": true,
-      "zotero": true,
-      "parsing": true,
-      "citation": true,
-      "materials": true,
-      "chemistry": true,
-      "media": true
-    },
-    "disabled": []
-  },
-  "defaults": {
-    "language": "en",
-    "citationStyle": "apa",
-    "literatureLimit": 20,
-    "preferredLiteratureProviders": ["semantic-scholar", "openalex", "crossref"],
-    "defaultImageProvider": "openai"
-  },
-  "research": {
-    "fallback": true,
-    "maxPages": 10,
-    "cacheTtlSeconds": 3600,
-    "providers": {
-      "semantic-scholar": {
-        "enabled": true,
-        "apiKeyEnv": "OMNISCHOLAR_SEMANTIC_SCHOLAR_API_KEY",
-        "maxPages": 10
-      },
-      "openalex": {
-        "enabled": true,
-        "email": "researcher@example.edu",
-        "maxPages": 10
-      },
-      "pubmed": {
-        "enabled": true,
-        "apiKeyEnv": "OMNISCHOLAR_NCBI_API_KEY",
-        "email": "researcher@example.edu",
-        "tool": "omnischolar",
-        "maxPages": 10
-      },
-      "arxiv": {
-        "enabled": true,
-        "maxPages": 10
-      },
-      "crossref": {
-        "enabled": true,
-        "email": "researcher@example.edu",
-        "maxPages": 10
-      },
-      "unpaywall": {
-        "enabled": false,
-        "email": "researcher@example.edu",
-        "maxPages": 10
-      },
-      "easyscholar": {
-        "enabled": false,
-        "apiKeyEnv": "OMNISCHOLAR_EASYSCHOLAR_API_KEY",
-        "maxPages": 5
-      }
-    }
-  },
-  "ai4scholar": {
-    "enabled": false,
-    "baseUrl": "https://ai4scholar.net",
-    "apiKeyEnv": "OMNISCHOLAR_AI4SCHOLAR_API_KEY",
-    "timeoutSeconds": 60,
-    "maxResponseBytes": 16777216,
-    "allowPaid": false
-  },
-  "zotero": {
-    "enabled": true,
-    "baseUrl": "http://127.0.0.1:23119/api",
-    "maxItems": 500
-  },
-  "mineru": {
-    "enabled": false,
-    "baseUrl": "https://mineru.net/api/v4",
-    "lightweightBaseUrl": "https://mineru.net/api/v1/agent",
-    "apiKeyEnv": "OMNISCHOLAR_MINERU_API_KEY",
-    "model": "pipeline",
-    "cacheDirectory": ".omnischolar/mineru",
-    "pollIntervalSeconds": 2,
-    "pollTimeoutSeconds": 600,
-    "maxPdfBytes": 209715200,
-    "allowExternalUpload": false,
-    "allowLightweightFallback": false
-  },
-  "data": {
-    "materialsProject": {
-      "enabled": false,
-      "baseUrl": "https://api.materialsproject.org",
-      "apiKeyEnv": "OMNISCHOLAR_MATERIALS_PROJECT_API_KEY",
-      "maxPages": 10
-    },
-    "casCommonChemistry": {
-      "enabled": false,
-      "apiKeyEnv": "OMNISCHOLAR_CAS_API_KEY",
-      "baseUrl": null,
-      "contractFile": null
-    }
-  },
-  "media": {
-    "allowExternalUpload": false,
-    "allowPaid": false,
-    "maxInputBytes": 26214400,
-    "maxArtifactBytes": 52428800,
-    "providers": {
-      "openai": {
-        "enabled": false,
-        "apiKeyEnv": "OMNISCHOLAR_OPENAI_API_KEY",
-        "baseUrl": "https://api.openai.com/v1",
-        "models": {
-          "gpt-image-1": {
-            "capabilities": ["text-to-image", "image-to-image", "edit", "multi-reference"],
-            "paid": true
-          }
-        },
-        "options": {}
-      },
-      "google": {
-        "enabled": false,
-        "apiKeyEnv": "OMNISCHOLAR_GEMINI_API_KEY",
-        "baseUrl": "https://generativelanguage.googleapis.com/v1beta",
-        "models": {},
-        "options": {}
-      },
-      "vertex": {
-        "enabled": false,
-        "apiKeyEnv": "OMNISCHOLAR_VERTEX_ACCESS_TOKEN",
-        "project": "your-project",
-        "location": "us-central1",
-        "models": {},
-        "options": {}
-      },
-      "xai": {
-        "enabled": false,
-        "apiKeyEnv": "OMNISCHOLAR_XAI_API_KEY",
-        "baseUrl": "https://api.x.ai/v1",
-        "models": {},
-        "options": {}
-      },
-      "fal": {
-        "enabled": false,
-        "apiKeyEnv": "OMNISCHOLAR_FAL_API_KEY",
-        "baseUrl": "https://fal.run",
-        "models": {},
-        "options": {}
-      },
-      "dashscope": {
-        "enabled": false,
-        "apiKeyEnv": "OMNISCHOLAR_DASHSCOPE_API_KEY",
-        "baseUrl": "https://dashscope.aliyuncs.com/api/v1",
-        "models": {},
-        "options": {}
-      },
-      "qwen-cloud": {
-        "enabled": false,
-        "apiKeyEnv": "OMNISCHOLAR_QWEN_API_KEY",
-        "baseUrl": "https://dashscope.aliyuncs.com/api/v1",
-        "models": {},
-        "options": {}
-      },
-      "atlas": {
-        "enabled": false,
-        "apiKeyEnv": "OMNISCHOLAR_ATLAS_API_KEY",
-        "baseUrl": "https://your-atlas-provider.example/v1",
-        "models": {},
-        "options": {}
-      },
-      "custom": {
-        "enabled": false,
-        "apiKeyEnv": "OMNISCHOLAR_CUSTOM_IMAGE_API_KEY",
-        "baseUrl": "https://images.example.edu/v1",
-        "models": {
-          "explicit-model-id": {
-            "capabilities": ["text-to-image"],
-            "paid": true
-          }
-        },
-        "options": {
-          "generationEndpoint": "images/generations",
-          "editEndpoint": "images/edits"
-        }
-      }
-    }
-  },
-  "sync": {
-    "namespace": null,
-    "cacheDirectory": ".omnischolar/sync",
-    "conflictPolicy": "preserve-local",
-    "recovery": true,
-    "backup": true,
-    "avoidUnnecessaryParse": true
-  },
-  "output": {
-    "rootDirectory": "omnischolar-output",
-    "conflictDirectory": ".conflicts",
-    "safeWrites": true
-  }
-}
+{
+  "schemaVersion": 1,
+  "runtime": {
+    "cacheDirectory": ".omnischolar/cache",
+    "python": "python",
+    "logLevel": "info",
+    "maxOutputBytes": 51200,
+    "maxOutputLines": 2000,
+    "maxResponseBytes": 16777216,
+    "requestTimeoutSeconds": 30,
+    "workspaceRoots": ["."]
+  },
+  "tools": {
+    "groups": {
+      "literature": true,
+      "ai4scholar": true,
+      "zotero": true,
+      "parsing": true,
+      "citation": true,
+      "materials": true,
+      "chemistry": true,
+      "media": true
+    },
+    "disabled": []
+  },
+  "defaults": {
+    "language": "en",
+    "citationStyle": "apa",
+    "literatureLimit": 20,
+    "preferredLiteratureProviders": ["semantic-scholar", "openalex", "crossref"],
+    "defaultImageProvider": "openai"
+  },
+  "research": {
+    "fallback": true,
+    "maxPages": 10,
+    "cacheTtlSeconds": 3600,
+    "providers": {
+      "semantic-scholar": {
+        "enabled": true,
+        "apiKeyEnv": "OMNISCHOLAR_SEMANTIC_SCHOLAR_API_KEY",
+        "maxPages": 10
+      },
+      "openalex": {
+        "enabled": true,
+        "email": "researcher@example.edu",
+        "maxPages": 10
+      },
+      "pubmed": {
+        "enabled": true,
+        "apiKeyEnv": "OMNISCHOLAR_NCBI_API_KEY",
+        "email": "researcher@example.edu",
+        "tool": "omnischolar",
+        "maxPages": 10
+      },
+      "arxiv": {
+        "enabled": true,
+        "maxPages": 10
+      },
+      "crossref": {
+        "enabled": true,
+        "email": "researcher@example.edu",
+        "maxPages": 10
+      },
+      "unpaywall": {
+        "enabled": false,
+        "email": "researcher@example.edu",
+        "maxPages": 10
+      },
+      "easyscholar": {
+        "enabled": false,
+        "apiKeyEnv": "OMNISCHOLAR_EASYSCHOLAR_API_KEY",
+        "maxPages": 5
+      }
+    }
+  },
+  "ai4scholar": {
+    "enabled": false,
+    "baseUrl": "https://ai4scholar.net",
+    "apiKeyEnv": "OMNISCHOLAR_AI4SCHOLAR_API_KEY",
+    "timeoutSeconds": 60,
+    "maxResponseBytes": 16777216,
+    "allowPaid": false
+  },
+  "zotero": {
+    "enabled": true,
+    "baseUrl": "http://127.0.0.1:23119/api",
+    "maxItems": 500
+  },
+  "mineru": {
+    "enabled": false,
+    "baseUrl": "https://mineru.net/api/v4",
+    "lightweightBaseUrl": "https://mineru.net/api/v1/agent",
+    "apiKeyEnv": "OMNISCHOLAR_MINERU_API_KEY",
+    "model": "pipeline",
+    "cacheDirectory": ".omnischolar/mineru",
+    "pollIntervalSeconds": 2,
+    "pollTimeoutSeconds": 600,
+    "maxPdfBytes": 209715200,
+    "allowExternalUpload": false,
+    "allowLightweightFallback": false
+  },
+  "data": {
+    "materialsProject": {
+      "enabled": false,
+      "baseUrl": "https://api.materialsproject.org",
+      "apiKeyEnv": "OMNISCHOLAR_MATERIALS_PROJECT_API_KEY",
+      "maxPages": 10
+    },
+    "casCommonChemistry": {
+      "enabled": false,
+      "apiKeyEnv": "OMNISCHOLAR_CAS_API_KEY",
+      "baseUrl": null,
+      "contractFile": null
+    }
+  },
+  "media": {
+    "allowExternalUpload": false,
+    "allowPaid": false,
+    "maxInputBytes": 26214400,
+    "maxArtifactBytes": 52428800,
+    "providers": {
+      "openai": {
+        "enabled": false,
+        "apiKeyEnv": "OMNISCHOLAR_OPENAI_API_KEY",
+        "baseUrl": "https://api.openai.com/v1",
+        "models": {
+          "gpt-image-1": {
+            "capabilities": ["text-to-image", "image-to-image", "edit", "multi-reference"],
+            "paid": true
+          }
+        },
+        "options": {}
+      },
+      "google": {
+        "enabled": false,
+        "apiKeyEnv": "OMNISCHOLAR_GEMINI_API_KEY",
+        "baseUrl": "https://generativelanguage.googleapis.com/v1beta",
+        "models": {},
+        "options": {}
+      },
+      "vertex": {
+        "enabled": false,
+        "apiKeyEnv": "OMNISCHOLAR_VERTEX_ACCESS_TOKEN",
+        "project": "your-project",
+        "location": "us-central1",
+        "models": {},
+        "options": {}
+      },
+      "xai": {
+        "enabled": false,
+        "apiKeyEnv": "OMNISCHOLAR_XAI_API_KEY",
+        "baseUrl": "https://api.x.ai/v1",
+        "models": {},
+        "options": {}
+      },
+      "fal": {
+        "enabled": false,
+        "apiKeyEnv": "OMNISCHOLAR_FAL_API_KEY",
+        "baseUrl": "https://fal.run",
+        "models": {},
+        "options": {}
+      },
+      "dashscope": {
+        "enabled": false,
+        "apiKeyEnv": "OMNISCHOLAR_DASHSCOPE_API_KEY",
+        "baseUrl": "https://your-workspace.cn-beijing.maas.aliyuncs.com/api/v1",
+        "models": {},
+        "options": {
+          "workspace": "your-workspace"
+        }
+      },
+      "qwen-cloud": {
+        "enabled": false,
+        "apiKeyEnv": "OMNISCHOLAR_QWEN_API_KEY",
+        "baseUrl": "https://your-workspace.ap-southeast-1.maas.aliyuncs.com/api/v1",
+        "models": {},
+        "options": {
+          "workspace": "your-workspace"
+        }
+      },
+      "atlas": {
+        "enabled": false,
+        "apiKeyEnv": "OMNISCHOLAR_ATLAS_API_KEY",
+        "baseUrl": "https://your-atlas-provider.example/v1",
+        "models": {},
+        "options": {}
+      },
+      "custom": {
+        "enabled": false,
+        "apiKeyEnv": "OMNISCHOLAR_CUSTOM_IMAGE_API_KEY",
+        "baseUrl": "https://images.example.edu/v1",
+        "models": {
+          "explicit-model-id": {
+            "capabilities": ["text-to-image"],
+            "paid": true
+          }
+        },
+        "options": {
+          "generationEndpoint": "images/generations",
+          "editEndpoint": "images/edits"
+        }
+      }
+    }
+  },
+  "sync": {
+    "namespace": null,
+    "cacheDirectory": ".omnischolar/sync",
+    "conflictPolicy": "preserve-local",
+    "recovery": true,
+    "backup": true,
+    "avoidUnnecessaryParse": true
+  },
+  "output": {
+    "rootDirectory": "omnischolar-output",
+    "conflictDirectory": ".conflicts",
+    "safeWrites": true
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luffysolution/omnischolar-pi",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Pi MCP bridge for the OmniScholar research toolkit",
   "type": "module",
   "license": "MIT",

package/pi-extension/dist/index.js

@@ -1,7 +1,7 @@
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
 import { Type } from "typebox";
-const CLIENT_INFO = { name: "omnischolar-pi", version: "0.1.1" };
+const CLIENT_INFO = { name: "omnischolar-pi", version: "0.1.3" };
 export function resultText(result) {
     return result.content
         .map((item) => {
@@ -38,8 +38,8 @@ export default function omnischolarExtension(pi) {
             return connection;
         connection = (async () => {
             transport = new StdioClientTransport({
-                command: "omnischolar",
-                args: ["mcp"],
+                command: "uvx",
+                args: ["--from", "luffysolution-omnischolar==0.1.3", "omnischolar", "mcp"],
                 stderr: "pipe",
             });
             client = new Client(CLIENT_INFO);