formlova-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FORMLOVA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,119 @@
+# formlova-mcp
+
+FORMLOVA MCP setup helper for Codex, Claude Code, Cursor, ChatGPT, and Gemini CLI.
+
+## Main connection URL
+
+Use this MCP server URL in any MCP-compatible client:
+
+`https://formlova.com/api/mcp`
+
+Reviewing setup instructions and registering the URL does not require a FORMLOVA account.  
+On first real use, you can log in or sign up during authentication.
+
+## Usage
+
+No install needed:
+
+```bash
+npx formlova-mcp print --client all
+```
+
+Project config write:
+
+```bash
+npx formlova-mcp install --client all --scope project --yes
+```
+
+Connectivity and local config check:
+
+```bash
+npx formlova-mcp doctor
+```
+
+## Commands
+
+### `print`
+
+Print setup snippets only (no file write).
+
+```bash
+npx formlova-mcp print --client codex
+npx formlova-mcp print --client claude-code
+npx formlova-mcp print --client cursor
+npx formlova-mcp print --client chatgpt
+npx formlova-mcp print --client gemini-cli
+```
+
+### `install`
+
+Writes project-level setup files.
+
+Supported writes:
+
+- Codex: `.codex/config.toml`
+- Claude Code: `.mcp.json`
+- Cursor: `.cursor/mcp.json`
+
+For ChatGPT and Gemini CLI, this command prints setup instructions (no local config file standard).
+
+```bash
+npx formlova-mcp install --client all --scope project --yes
+```
+
+### `doctor`
+
+Checks:
+
+- `https://formlova.com/api/mcp` reachability
+- Presence of common local setup files
+
+```bash
+npx formlova-mcp doctor
+```
+
+## Client quick references
+
+### Claude
+
+- Settings > Connectors で Remote MCP を追加
+- Docs: https://support.anthropic.com/en/articles/11175166-how-do-i-connect-to-remote-mcp-servers-from-claude-desktop
+
+### ChatGPT
+
+- 開発者モード時: 設定 > アプリ > 高度な設定（アプリを作成する）
+- Docs: https://platform.openai.com/docs/guides/tools-remote-mcp
+
+### Codex
+
+```bash
+codex mcp add formlova --url https://formlova.com/api/mcp
+```
+
+### Claude Code
+
+```bash
+claude mcp add --transport http formlova https://formlova.com/api/mcp
+```
+
+### Cursor
+
+```json
+{
+  "mcpServers": {
+    "formlova": {
+      "url": "https://formlova.com/api/mcp"
+    }
+  }
+}
+```
+
+### Gemini CLI
+
+```bash
+gemini mcp add --transport http formlova https://formlova.com/api/mcp
+```
+
+## Notes
+
+Client-side setup menus and steps may change without notice.

package/bin/formlova-mcp.mjs

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+
+import fs from "node:fs";
+import path from "node:path";
+
+const MCP_URL = "https://formlova.com/api/mcp";
+const VALID_CLIENTS = new Set([
+  "all",
+  "codex",
+  "claude-code",
+  "cursor",
+  "chatgpt",
+  "gemini-cli",
+]);
+
+function printHelp() {
+  console.log(`formlova-mcp
+
+Usage:
+  formlova-mcp print --client <client|all>
+  formlova-mcp install --client <client|all> [--scope project] [--yes]
+  formlova-mcp doctor
+
+Options:
+  --client   all | codex | claude-code | cursor | chatgpt | gemini-cli
+  --scope    project (default) | user
+  --yes      write files without prompt
+`);
+}
+
+function parseArgs(argv) {
+  const [command, ...rest] = argv;
+  const args = { command, client: "all", scope: "project", yes: false };
+  for (let i = 0; i < rest.length; i += 1) {
+    const token = rest[i];
+    if (token === "--client") args.client = rest[i + 1] ?? "all";
+    if (token === "--scope") args.scope = rest[i + 1] ?? "project";
+    if (token === "--yes") args.yes = true;
+    if (token === "--help" || token === "-h") args.command = "help";
+  }
+  return args;
+}
+
+function snippets() {
+  return {
+    codex: `codex mcp add formlova --url ${MCP_URL}`,
+    "claude-code": `claude mcp add --transport http formlova ${MCP_URL}`,
+    cursor: `{
+  "mcpServers": {
+    "formlova": {
+      "url": "${MCP_URL}"
+    }
+  }
+}`,
+    chatgpt: "ChatGPT (developer mode): Settings > Apps > Advanced settings (Create app), then add MCP server URL.",
+    "gemini-cli": `gemini mcp add --transport http formlova ${MCP_URL}`,
+  };
+}
+
+function resolveClients(target) {
+  if (!VALID_CLIENTS.has(target)) {
+    throw new Error(`Invalid --client: ${target}`);
+  }
+  if (target === "all") {
+    return ["codex", "claude-code", "cursor", "chatgpt", "gemini-cli"];
+  }
+  return [target];
+}
+
+function printConfig(client) {
+  const s = snippets();
+  console.log(`\n[${client}]`);
+  console.log(s[client]);
+}
+
+function ensureDir(filePath) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+}
+
+function writeProjectConfig(client) {
+  if (client === "codex") {
+    const target = path.resolve(process.cwd(), ".codex/config.toml");
+    ensureDir(target);
+    const content = `[mcp_servers.formlova]
+url = "${MCP_URL}"
+`;
+    fs.writeFileSync(target, content, "utf8");
+    console.log(`Wrote ${target}`);
+    return;
+  }
+  if (client === "claude-code") {
+    const target = path.resolve(process.cwd(), ".mcp.json");
+    ensureDir(target);
+    const content = JSON.stringify(
+      { mcpServers: { formlova: { url: MCP_URL } } },
+      null,
+      2
+    );
+    fs.writeFileSync(target, `${content}\n`, "utf8");
+    console.log(`Wrote ${target}`);
+    return;
+  }
+  if (client === "cursor") {
+    const target = path.resolve(process.cwd(), ".cursor/mcp.json");
+    ensureDir(target);
+    const content = JSON.stringify(
+      { mcpServers: { formlova: { url: MCP_URL } } },
+      null,
+      2
+    );
+    fs.writeFileSync(target, `${content}\n`, "utf8");
+    console.log(`Wrote ${target}`);
+    return;
+  }
+  if (client === "chatgpt" || client === "gemini-cli") {
+    printConfig(client);
+  }
+}
+
+async function runDoctor() {
+  try {
+    const res = await fetch(MCP_URL, { method: "GET" });
+    console.log(`MCP URL check: ${res.status} ${res.statusText}`);
+  } catch (err) {
+    console.log(`MCP URL check: failed (${String(err)})`);
+  }
+
+  const checks = [
+    ".codex/config.toml",
+    ".mcp.json",
+    ".cursor/mcp.json",
+  ];
+  for (const p of checks) {
+    const abs = path.resolve(process.cwd(), p);
+    console.log(`${p}: ${fs.existsSync(abs) ? "found" : "not found"}`);
+  }
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  if (!args.command || args.command === "help") {
+    printHelp();
+    return;
+  }
+
+  if (args.command === "print") {
+    for (const client of resolveClients(args.client)) printConfig(client);
+    return;
+  }
+
+  if (args.command === "install") {
+    if (args.scope === "user") {
+      console.log("User-scope auto-write is not enabled yet.");
+      console.log("Use --scope project or run: formlova-mcp print --client all");
+      return;
+    }
+    if (!args.yes) {
+      console.log("Add --yes to write files. Example:");
+      console.log("  formlova-mcp install --client all --scope project --yes");
+      return;
+    }
+    for (const client of resolveClients(args.client)) writeProjectConfig(client);
+    return;
+  }
+
+  if (args.command === "doctor") {
+    await runDoctor();
+    return;
+  }
+
+  printHelp();
+  process.exitCode = 1;
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exitCode = 1;
+});
+

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "formlova-mcp",
+  "version": "0.1.0",
+  "description": "FORMLOVA MCP setup helper CLI",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "formlova-mcp": "bin/formlova-mcp.mjs"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.17"
+  },
+  "scripts": {
+    "start": "node bin/formlova-mcp.mjs",
+    "check": "node bin/formlova-mcp.mjs doctor"
+  },
+  "keywords": [
+    "mcp",
+    "formlova",
+    "codex",
+    "claude-code",
+    "cursor",
+    "chatgpt",
+    "gemini-cli"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/formlova/formlova-mcp.git"
+  },
+  "homepage": "https://github.com/formlova/formlova-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/formlova/formlova-mcp/issues"
+  }
+}