formlab-mcp 0.1.0 → 0.1.1

package/README.md

@@ -1,5 +1,9 @@
 # formlab-mcp
 
+[![npm](https://img.shields.io/npm/v/formlab-mcp.svg)](https://www.npmjs.com/package/formlab-mcp)
+[![license](https://img.shields.io/npm/l/formlab-mcp.svg)](https://github.com/juliu1980/FormLab/blob/main/LICENSE)
+[![FormLab](https://img.shields.io/badge/site-formvix.com-2563eb.svg)](https://formvix.com)
+
 A **read-only Model Context Protocol server** for [FormLab](https://formvix.com). Lets Claude (or any MCP-compatible AI assistant) read and analyze your local FormLab database — your formulations, ingredients, batches, samples and test results — **without your data ever leaving your machine**.
 
 > Local-first + AI-native. Your proprietary recipes stay on your laptop; only the LLM's answer to your question travels.
@@ -37,11 +41,12 @@ Ask Claude (or another MCP client) things like:
 ## Install
 
 ```bash
-# From npm (once published):
-npm install -g formlab-mcp
-
-# Or run directly without installing:
+# Run directly without installing — recommended:
 npx formlab-mcp /path/to/formlab-export.json
+
+# Or install globally for repeated use:
+npm install -g formlab-mcp
+formlab-mcp /path/to/formlab-export.json
 ```
 
 For local development from this repo:

package/SUBMISSION.md

@@ -0,0 +1,129 @@
+# MCP submission — ready-to-paste materials
+
+Both directory paths are prepped. Path B is fastest; Path A is the canonical
+registry placement. Recommended order: B first (immediate discoverability),
+then A (long-term legitimacy).
+
+---
+
+## Path B — `awesome-mcp-servers` PR
+
+Three lists worth submitting to, in rough order of reach:
+
+1. **[punkpeye/awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers)** (~50k stars, primary)
+2. **[appcypher/awesome-mcp-servers](https://github.com/appcypher/awesome-mcp-servers)**
+3. **[wong2/awesome-mcp-servers](https://github.com/wong2/awesome-mcp-servers)**
+
+### Entry markdown (drop into the right category section)
+
+```markdown
+- [**formlab-mcp**](https://github.com/juliu1980/FormLab/tree/main/mcp) - Local-first read access to your [FormLab](https://formvix.com) lab notebook — formulations, ingredients, batches, samples, test results, DOE matrices. Data stays on your machine; only the LLM's answer travels. [![npm](https://img.shields.io/npm/v/formlab-mcp.svg)](https://www.npmjs.com/package/formlab-mcp)
+```
+
+### Suggested category
+
+Best fit on `punkpeye/awesome-mcp-servers`: **"📊 Data Science Tools"** or
+**"🔬 Knowledge & Memory"** depending on how the list is structured. Skim the
+TOC and pick whichever section already has domain-specific lab/research
+servers. If neither fits, **"🛠️ Other Tools and Integrations"** is the safe
+catch-all.
+
+### PR title
+
+```
+Add formlab-mcp — local-first lab-notebook server for chem/cosmetic R&D
+```
+
+### PR body
+
+```markdown
+Adds **formlab-mcp**, a read-only MCP server that exposes a [FormLab](https://formvix.com)
+lab notebook export to Claude (or any MCP client). FormLab is a browser-based
+local-first ELN for formulation R&D — paints, coatings, cosmetics, polymers.
+
+The server lets users ask Claude things like _"which of my formulations use
+silicone fluid at 5%+?"_, _"compare FORM-001 and FORM-004 side by side"_,
+_"what parameters fail acceptance most often?"_, or _"show me the DOE matrix
+at sample grain for Anti-Aging Serum family"_ — all against a JSON export
+that stays on the user's laptop.
+
+**15 read-only tools** covering formulations, ingredients, batches, samples,
+test results, DOE matrices, similarity, failure analysis, coverage matrices.
+
+- Repo: https://github.com/juliu1980/FormLab/tree/main/mcp
+- npm: https://www.npmjs.com/package/formlab-mcp
+- Node 18+; runs via `npx formlab-mcp /path/to/export.json`
+- License: MIT
+
+Happy to move the entry to a different category if there's a better fit.
+```
+
+### Submission workflow
+
+For each fork target above:
+
+1. Visit https://github.com/punkpeye/awesome-mcp-servers (or the alt)
+2. Open `README.md` → click ✏ (Edit) → GitHub will fork on your behalf
+3. Find the appropriate `###` category section
+4. Paste the **Entry markdown** in alphabetical order within the section
+5. Commit message: `Add formlab-mcp`
+6. Open PR with the **PR title** and **PR body** above
+
+Total time for all three: ~15 minutes.
+
+---
+
+## Path A — Official MCP Registry
+
+This places `formlab-mcp` in `https://registry.modelcontextprotocol.io`,
+which is what future MCP-aware tools will query first.
+
+### Prereqs
+
+```bash
+# Go 1.24+ — needed to build mcp-publisher
+brew install go
+
+# Build the publisher CLI
+git clone https://github.com/modelcontextprotocol/registry
+cd registry
+make publisher          # produces ./bin/mcp-publisher
+sudo mv bin/mcp-publisher /usr/local/bin/  # or add to PATH
+```
+
+### Manifest
+
+Already written to `mcp/server.json` in this repo. Uses:
+- Namespace: `io.github.juliu1980/formlab-mcp` (GitHub OAuth proves ownership)
+- Status: `active`
+- Repository: `https://github.com/juliu1980/FormLab` with subfolder `mcp`
+- Version: pulled from `package.json` (currently `0.1.1`)
+- Package: npm `formlab-mcp` with stdio transport + positional `exportPath` arg
+
+### Publish (the OAuth step is interactive)
+
+```bash
+cd /Users/juliu/Documents/GitHub/formlab/mcp
+mcp-publisher login        # opens GitHub OAuth in your browser as juliu1980
+mcp-publisher publish      # reads server.json and submits
+```
+
+### Verify
+
+After publish, the server appears at:
+- `https://registry.modelcontextprotocol.io/v0/servers?search=formlab`
+
+### Versioning future updates
+
+Bump `package.json` `version` AND `mcp/server.json`'s `version` + the package
+version, then re-run `mcp-publisher publish`. The CLI rejects duplicate
+version submissions.
+
+---
+
+## After both paths land
+
+- Post to X / LinkedIn announcing it (memory file has a draft)
+- Cross-post to r/cosmeticchemistry, r/paint, r/Chemistry — any lab-adjacent
+  subreddits where local-first + AI lands well
+- Add a section to the formvix.com landing page linking to the registry entry

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "formlab-mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Read-only Model Context Protocol server for FormLab — lets Claude (and other MCP clients) read and analyze your local FormLab export. Your recipes never leave your machine.",
   "type": "module",
   "bin": {

package/server.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.juliu1980/formlab-mcp",
+  "description": "Read-only MCP for FormLab — talk to your local lab notebook via Claude. Data stays local.",
+  "version": "0.1.1",
+  "websiteUrl": "https://formvix.com",
+  "repository": {
+    "url": "https://github.com/juliu1980/FormLab",
+    "source": "github",
+    "subfolder": "mcp"
+  },
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "formlab-mcp",
+      "version": "0.1.1",
+      "runtimeHint": "npx",
+      "transport": {
+        "type": "stdio"
+      },
+      "packageArguments": [
+        {
+          "type": "positional",
+          "name": "exportPath",
+          "description": "Absolute path to a FormLab export JSON file (Data → Export JSON in the FormLab UI).",
+          "isRequired": true,
+          "format": "filepath",
+          "value": "/path/to/formlab-export.json"
+        }
+      ]
+    }
+  ]
+}