veriscope-mcp 1.0.0 → 1.1.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.
- package/LICENSE +21 -21
- package/README.md +153 -141
- package/README_ZH.md +129 -155
- package/bin/index.js +619 -472
- package/glama.json +45 -45
- package/golden_sandbox_50.json +1757 -1757
- package/package.json +40 -40
- package/smithery.yaml +17 -17
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 VeriScope Sovereign Harbor
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 VeriScope Sovereign Harbor
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,141 +1,153 @@
|
|
|
1
|
-
# VeriScope MCP Server (@veriscope/mcp-server)
|
|
2
|
-
|
|
3
|
-
> **VeriScope** is a sovereign cryptographic bibliographic index and citation verification engine for AI Agents. It anchors AI Task Planners in verified scholarly editions across 24 disciplines with **exact chapter coordinates**, **verbatim fair-use excerpts (<=300 chars)**, **64-bit SHA-256 edition hashes**, and **Ed25519 tamper-proof digital receipts (`vsk_sig`)**.
|
|
4
|
-
|
|
5
|
-
[](LICENSE)
|
|
7
|
-
[](#zero-config-golden-sandbox)
|
|
8
|
-
[](#dual-track-pricing--access-tiers)
|
|
9
|
-
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
## 🌟 Why VeriScope?
|
|
13
|
-
|
|
14
|
-
When AI Agents conduct research, general-purpose LLMs generate plausible yet ungrounded citations,
|
|
15
|
-
|
|
16
|
-
### Scenario 1: Max Weber Citation Verification (*The Protestant Ethic*)
|
|
17
|
-
* **The Task**: "Cite Max Weber's precise German-to-English thesis on the spirit of capitalism and its ascetic calling."
|
|
18
|
-
* ❌ **Vanilla LLM (Hallucinated)**:
|
|
19
|
-
> "Weber writes in Chapter 2, page 181: 'The modern capitalist spirit arose purely from Calvinist predestination.' (Weber, 1905, Scribner edition)."
|
|
20
|
-
> *Audit*: Fabricated page number; inaccurate quotation; no cryptographic edition hash.
|
|
21
|
-
* ✅ **VeriScope MCP (`veriscope_locate_evidence`)**:
|
|
22
|
-
> **Edition**: *The Protestant Ethic and the Spirit of Capitalism* (Archival ID: Sovereign Harbor Verified Edition)
|
|
23
|
-
> **Coordinate**: Section 2: "The Spirit of Capitalism", Paragraph 12
|
|
24
|
-
> **Verbatim Excerpt (<=300 chars)**: *"Man is dominated by the making of money, by acquisition as the ultimate purpose of his life. Economic acquisition is no longer subordinated to man as the means for the satisfaction of his material needs."*
|
|
25
|
-
> **Edition SHA-256**: `d7a8fbb5628549...3984e1`
|
|
26
|
-
> **Receipt**: `vsk_sig:ed25519_8f0a2e...` (Cryptographically verified against tamper-lock)
|
|
27
|
-
|
|
28
|
-
---
|
|
29
|
-
|
|
30
|
-
### Scenario 2: Hans Kelsen vs. Carl Schmitt on Legal Sovereignty
|
|
31
|
-
* **The Task**: "Contrast Hans Kelsen's Pure Theory of Law with Carl Schmitt's Decisionism regarding the State of Exception."
|
|
32
|
-
* ❌ **Vanilla LLM (Flat Synthesis)**:
|
|
33
|
-
> "Both scholars contributed to German legal theory. Kelsen believed in the rule of law and the Basic Norm, while Schmitt emphasized political authority during crises. They represent complementary aspects of jurisprudence."
|
|
34
|
-
> *Audit*: Flattens an irreconcilable Weimar constitutional duel into false harmony.
|
|
35
|
-
* ✅ **VeriScope MCP (`veriscope_inspect_topography`)**:
|
|
36
|
-
> **Formal Kernel**: Pure normativism (*Reine Rechtslehre*) vs. Political existential decisionism (*Dezisionismus*).
|
|
37
|
-
> **Lineages**: Hans Kelsen (Wikidata Q84322) vs. Carl Schmitt (Wikidata Q57476).
|
|
38
|
-
> **Dialectical Disputes (3 Core Theses)**:
|
|
39
|
-
> 1. *Norm vs. Exception*: Kelsen posits law as a self-contained hierarchy deriving validity solely from the Grundnorm; Schmitt counters that the sovereign is "he who decides on the exception" (*Ausnahmezustand*), where norm yields to concrete order.
|
|
40
|
-
> 2. *Guardian of the Constitution*: Kelsen's 1928 constitutional court doctrine vs. Schmitt's 1931 *Der Huter der Verfassung* asserting the Reich President as sole guardian.
|
|
41
|
-
> 3. *Validity vs. Facticity*: Logical purity of legal norms versus existential political will.
|
|
42
|
-
|
|
43
|
-
---
|
|
44
|
-
|
|
45
|
-
### Scenario 3: Keynesian Liquidity Trap (*General Theory*)
|
|
46
|
-
* **The Task**: "Explain the exact institutional boundary of Keynes's liquidity trap and verify against primary economic texts."
|
|
47
|
-
* ❌ **Vanilla LLM (Secondary Paraphrase)**:
|
|
48
|
-
> "Keynes explained that when interest rates are zero, monetary policy becomes ineffective because people hold cash."
|
|
49
|
-
* ✅ **VeriScope MCP (`veriscope_locate_evidence` & `veriscope_verify_attestation`)**:
|
|
50
|
-
> **Formal Axiom**: Absolute liquidity preference under asymptotic flat LM-curve conditions where $\partial M / \partial r
|
|
51
|
-
> **Primary Location**: *The General Theory of Employment, Interest and Money*, Chapter 15 ("The Psychological and Business Incentives to Liquidity"), Section II.
|
|
52
|
-
> **Verification Status**: `VERIFIED_AUTHENTIC` (SHA-256 matched with primary English edition).
|
|
53
|
-
|
|
54
|
-
---
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
1
|
+
# VeriScope MCP Server (@veriscope/mcp-server)
|
|
2
|
+
|
|
3
|
+
> **VeriScope** is a sovereign cryptographic bibliographic index and citation verification engine for AI Agents. It anchors AI Task Planners in verified scholarly editions across 24 disciplines with **exact chapter coordinates**, **verbatim fair-use excerpts (<=300 chars)**, **64-bit SHA-256 edition hashes**, and **Ed25519 tamper-proof digital receipts (`vsk_sig`)**.
|
|
4
|
+
|
|
5
|
+
[](https://modelcontextprotocol.io)
|
|
6
|
+
[](LICENSE)
|
|
7
|
+
[](#zero-config-golden-sandbox)
|
|
8
|
+
[](#dual-track-pricing--access-tiers)
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## 🌟 Why VeriScope? Four High-Impact Scenarios (Academic & Executive Strategy)
|
|
13
|
+
|
|
14
|
+
When AI Agents conduct research or draft strategic memos, general-purpose LLMs generate plausible yet ungrounded citations, saturate drafts with generic corporate clichés ("AI slop"), or flatten vigorous intellectual conflicts into milquetoast compromises. VeriScope provides a **deterministic factual & dialectical anchor**:
|
|
15
|
+
|
|
16
|
+
### Scenario 1: Max Weber Citation Verification (*The Protestant Ethic*)
|
|
17
|
+
* **The Task**: "Cite Max Weber's precise German-to-English thesis on the spirit of capitalism and its ascetic calling."
|
|
18
|
+
* ❌ **Vanilla LLM (Hallucinated)**:
|
|
19
|
+
> "Weber writes in Chapter 2, page 181: 'The modern capitalist spirit arose purely from Calvinist predestination.' (Weber, 1905, Scribner edition)."
|
|
20
|
+
> *Audit*: Fabricated page number; inaccurate quotation; no cryptographic edition hash.
|
|
21
|
+
* ✅ **VeriScope MCP (`veriscope_locate_evidence`)**:
|
|
22
|
+
> **Edition**: *The Protestant Ethic and the Spirit of Capitalism* (Archival ID: Sovereign Harbor Verified Edition)
|
|
23
|
+
> **Coordinate**: Section 2: "The Spirit of Capitalism", Paragraph 12
|
|
24
|
+
> **Verbatim Excerpt (<=300 chars)**: *"Man is dominated by the making of money, by acquisition as the ultimate purpose of his life. Economic acquisition is no longer subordinated to man as the means for the satisfaction of his material needs."*
|
|
25
|
+
> **Edition SHA-256**: `d7a8fbb5628549...3984e1`
|
|
26
|
+
> **Receipt**: `vsk_sig:ed25519_8f0a2e...` (Cryptographically verified against tamper-lock)
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
### Scenario 2: Hans Kelsen vs. Carl Schmitt on Legal Sovereignty
|
|
31
|
+
* **The Task**: "Contrast Hans Kelsen's Pure Theory of Law with Carl Schmitt's Decisionism regarding the State of Exception."
|
|
32
|
+
* ❌ **Vanilla LLM (Flat Synthesis)**:
|
|
33
|
+
> "Both scholars contributed to German legal theory. Kelsen believed in the rule of law and the Basic Norm, while Schmitt emphasized political authority during crises. They represent complementary aspects of jurisprudence."
|
|
34
|
+
> *Audit*: Flattens an irreconcilable Weimar constitutional duel into false harmony.
|
|
35
|
+
* ✅ **VeriScope MCP (`veriscope_inspect_topography`)**:
|
|
36
|
+
> **Formal Kernel**: Pure normativism (*Reine Rechtslehre*) vs. Political existential decisionism (*Dezisionismus*).
|
|
37
|
+
> **Lineages**: Hans Kelsen (Wikidata Q84322) vs. Carl Schmitt (Wikidata Q57476).
|
|
38
|
+
> **Dialectical Disputes (3 Core Theses)**:
|
|
39
|
+
> 1. *Norm vs. Exception*: Kelsen posits law as a self-contained hierarchy deriving validity solely from the Grundnorm; Schmitt counters that the sovereign is "he who decides on the exception" (*Ausnahmezustand*), where norm yields to concrete order.
|
|
40
|
+
> 2. *Guardian of the Constitution*: Kelsen's 1928 constitutional court doctrine vs. Schmitt's 1931 *Der Huter der Verfassung* asserting the Reich President as sole guardian.
|
|
41
|
+
> 3. *Validity vs. Facticity*: Logical purity of legal norms versus existential political will.
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
### Scenario 3: Keynesian Liquidity Trap (*General Theory*)
|
|
46
|
+
* **The Task**: "Explain the exact institutional boundary of Keynes's liquidity trap and verify against primary economic texts."
|
|
47
|
+
* ❌ **Vanilla LLM (Secondary Paraphrase)**:
|
|
48
|
+
> "Keynes explained that when interest rates are zero, monetary policy becomes ineffective because people hold cash."
|
|
49
|
+
* ✅ **VeriScope MCP (`veriscope_locate_evidence` & `veriscope_verify_attestation`)**:
|
|
50
|
+
> **Formal Axiom**: Absolute liquidity preference under asymptotic flat LM-curve conditions where $\partial M / \partial r \to \infty$.
|
|
51
|
+
> **Primary Location**: *The General Theory of Employment, Interest and Money*, Chapter 15 ("The Psychological and Business Incentives to Liquidity"), Section II.
|
|
52
|
+
> **Verification Status**: `VERIFIED_AUTHENTIC` (SHA-256 matched with primary English edition).
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
56
|
+
### Scenario 4: Executive Briefing Elevation & Pre-Mortem Red-Teaming (De-Slop & Grounding)
|
|
57
|
+
* **The Task**: "De-slop this corporate proposal on organizational friction, elevate it to first-principles institutional economics, and run a pre-mortem red-team audit before the board review."
|
|
58
|
+
* ❌ **Vanilla LLM (Generic Corporate Slop)**:
|
|
59
|
+
> "We must break down silos, leverage digital synergies, and align cross-functional stakeholders to drive end-to-end transformation."
|
|
60
|
+
* ✅ **VeriScope MCP (`veriscope_discover_concepts` / `veriscope_inspect_topography` / `veriscope_locate_evidence`)**:
|
|
61
|
+
> **First-Principles Elevation**: Maps colloquial "silos and red tape" to Max Weber's **Iron Cage of Bureaucracy (`VS-SOC-001`)** and Coasean **Transaction Cost Economics (`VS-ECON-004`)**.
|
|
62
|
+
> **Pre-Mortem Red-Team Challenges**: Exposes 3 structural blind spots (e.g., why adding digital coordination layers without altering incentive compatibility increases internal transaction friction).
|
|
63
|
+
> **Attested Grounding**: Anchors the executive memo with a <=300-char primary excerpt and Ed25519 receipt (`vsk_sig`).
|
|
64
|
+
|
|
65
|
+
---
|
|
66
|
+
|
|
67
|
+
## 🛠️ The 4+1+1 Cognitive Funnel Tool Matrix (with Citation Audit) (with Business Routing Aliases)
|
|
68
|
+
|
|
69
|
+
| Tool Name ( & Business Alias) | Input Parameters | Primary Output | Use Case |
|
|
70
|
+
| :--- | :--- | :--- | :--- |
|
|
71
|
+
| `veriscope_discover_concepts`<br>*(Alias: `veriscope_business_frame`)* | `query: str`, `discipline_hint?: str` | Standardized canonical ontology, formal definition, Sino-Western comparative counterpart | Elevate colloquial concepts, workplace pain points, or news metaphors into formal academic & strategic frameworks |
|
|
72
|
+
| `veriscope_inspect_topography`<br>*(Alias: `veriscope_redteam_audit`)* | `concept_id: str` | `formal_kernel`, Wikidata QIDs, and 3+ structured `dialectical_disputes` | Pre-mortem red-teaming; prevent shallow syntheses; ground the agent in rival axioms and blind spots |
|
|
73
|
+
| `veriscope_locate_evidence`<br>*(Alias: `veriscope_deslop_and_ground`)* | `concept_id: str`, `proposition?: str` | Verbatim fair-use slice (**<=300 chars**), chapter coordinate, 64-bit SHA-256, Ed25519 receipt | Replace synthetic AI filler with attested primary editions and peer-reviewable cryptographic proof |
|
|
74
|
+
| `veriscope_verify_attestation` | `concept_id: str`, `claimed_sha256: str`, `verbatim_slice?: str` | `is_valid: bool`, `verification_status: "VERIFIED_AUTHENTIC" \| "TAMPER_DETECTED"` | Zero-knowledge cryptographic check for citations, journal peer review, and compliance fact auditing |
|
|
75
|
+
| `veriscope_probe_radar` | `concept_id: str` | Cross-disciplinary synaptic radar links, epistemological blind spots | Interdisciplinary research, cognitive blind spot alerts, and synthetic conceptual discovery |
|
|
76
|
+
| `veriscope_citation_audit` | `text: str`, `discipline_hint?: str` | Extracted citations, author alignment, SHA-256 grounding, health score (0-100), hallucination detection | **AI Citation Health Check**: Fast-scan drafts to detect fabricated AI citations and misattributions |
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
## ⚡ Zero-Config Golden Sandbox
|
|
81
|
+
|
|
82
|
+
VeriScope ships with a **built-in 50-Canon Golden Sandbox** (`golden_sandbox_50.json`, ~126 KB).
|
|
83
|
+
|
|
84
|
+
* **Instant Offline Exploration**: Reviewers and developers can inspect, locate, and verify citations immediately upon installation **without signing up or providing any API key**.
|
|
85
|
+
* **10 Disciplines x 5 Canons**: Covers Philosophy (Kant, Plato, Descartes, Nietzsche, Spinoza), Sociology (Weber, Durkheim, Marx, Simmel, Parsons), Political Theory (Schmitt, Hobbes, Locke, Machiavelli, Rawls), Economics (Keynes, Smith, Hayek, Schumpeter, Ricardo), Law (Kelsen, Hart, Dworkin, Fuller, Savigny), History, Literature, Psychology, Communication, and Philosophy of Science (Kuhn, Popper, Lakatos, Feyerabend, Merton).
|
|
86
|
+
* **Teaser Mode for Long-Tail Canons**: When querying concepts beyond the 50 sandbox canons without an API key, VeriScope **does not crash with a 401 error**. Instead, it returns a **Cryptographic Teaser Preview** containing the matched canon title, chapter coordinate, and a non-empty `canon_sha256_prefix`, keeping the Agent's reasoning workflow alive.
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
## 💳 Dual-Track Pricing & Access Tiers
|
|
91
|
+
|
|
92
|
+
VeriScope utilizes a **hybrid subscription and credit-pack model** designed to eliminate per-call micro-payment anxiety for automated research pipelines:
|
|
93
|
+
|
|
94
|
+
| Plan / Tier | Target Audience | Domestic Pricing (WeChat / Alipay) | Global Pricing (Payoneer Checkout) | Included Quota / Benefits |
|
|
95
|
+
| :--- | :--- | :--- | :--- | :--- |
|
|
96
|
+
| **Community Sandbox** | Developers & Evaluators | **Free (¥0)** | **Free ($0)** | 50 Golden Canons full access + Teaser previews for all long-tail concepts |
|
|
97
|
+
| **Scholar Pro** | Researchers & PhD Candidates | **¥128 / month** | **$19 / month** | Unlimited standard queries, 5,000 evidence slices/mo, full Ed25519 attestation receipts |
|
|
98
|
+
| **Power Credit Pack** | Agent Builders & Automated Pipelines | **¥68 / 500 credits** | **$10 / 500 credits** | Flexible top-up for high-frequency automated batch synthesis |
|
|
99
|
+
| **Enterprise / Institution** | Academic Labs & Law Firms | **¥5,000 / year** | **$800 / year** | Dedicated rate limits, IP whitelist, institutional co-signing keys, SLA guarantee |
|
|
100
|
+
|
|
101
|
+
*To activate your key, visit [https://veriscope.cc/pricing](https://veriscope.cc/pricing) or configure `VERISCOPE_API_KEY`.*
|
|
102
|
+
|
|
103
|
+
---
|
|
104
|
+
|
|
105
|
+
## 🚀 Quick Start & Integration
|
|
106
|
+
|
|
107
|
+
### Claude Desktop / Claude Code
|
|
108
|
+
Add to your `claude_desktop_config.json`:
|
|
109
|
+
```json
|
|
110
|
+
{
|
|
111
|
+
"mcpServers": {
|
|
112
|
+
"veriscope": {
|
|
113
|
+
"command": "npx",
|
|
114
|
+
"args": ["-y", "@veriscope/mcp-server"],
|
|
115
|
+
"env": {
|
|
116
|
+
"VERISCOPE_API_KEY": "vsk_live_optional_your_key_here"
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
### Cursor & Windsurf
|
|
124
|
+
Add as a new stdio MCP server:
|
|
125
|
+
- **Command**: `npx`
|
|
126
|
+
- **Arguments**: `-y @veriscope/mcp-server`
|
|
127
|
+
|
|
128
|
+
### Python / uvx Alternative
|
|
129
|
+
```json
|
|
130
|
+
{
|
|
131
|
+
"mcpServers": {
|
|
132
|
+
"veriscope": {
|
|
133
|
+
"command": "uvx",
|
|
134
|
+
"args": ["veriscope-mcp"]
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
---
|
|
141
|
+
|
|
142
|
+
## 🔒 Security, Privacy & Scholarly Fair-Use Compliance
|
|
143
|
+
|
|
144
|
+
1. **Read-Only Engine**: VeriScope operates strictly in read-only mode (`mode=ro`). It never writes to the host filesystem.
|
|
145
|
+
2. **Scholarly Fair-Use Doctrine**: VeriScope is a cryptographic bibliographic index and citation verification engine. It never distributes or transmits full book copies; verbatim evidence excerpts are hard-capped at **strictly <=300 characters** around the proposition anchor.
|
|
146
|
+
3. **Cryptographic Ed25519 Receipts**: Every attested quote is signed with the slice's 16-hex hash (`slice_sha256_16`) in the payload `VERISCOPE_ATTESTATION:{concept_id}:{canon_sha256}:{slice_sha16}:{timestamp}`, providing tamper-evident authenticity for scholarly peer review.
|
|
147
|
+
4. **Entropy Rate Limiting (F8 Shield)**: High-entropy scraping attacks triggering cross-disciplinary jumps across $\ge 6$ disciplines in short bursts automatically drop into **Zero-Text Proof Mode** (yielding only coordinates and SHA-256 prefixes), protecting the sovereign archive while maintaining zero-hallucination factual integrity.
|
|
148
|
+
|
|
149
|
+
---
|
|
150
|
+
|
|
151
|
+
## 📄 License
|
|
152
|
+
|
|
153
|
+
MIT License. See [LICENSE](LICENSE) for details.
|