mongo-ts

name	mongo-ts
description	MongoDB CLI 工具。直接執行 MongoDB 查詢語法，支援 CRUD、聚合、索引管理。輸出格式：table/json/csv/yaml。預設唯讀模式保護生產環境。

mongo-ts

MongoDB 命令列工具，直接執行查詢語法。

執行方式

npx @lova/mongo-ts -u "mongodb://..." -q "db.users.find()"

命令選項

選項	說明
-q, --query <query>	執行查詢字串（必填）
-u, --uri <uri>	MongoDB 連線字串
-d, --db <database>	指定資料庫
-f, --format <type>	輸出格式：table/json/csv/yaml（預設 table）
--allow-write	允許寫入操作（預設唯讀）
--quiet	靜默模式，只輸出資料
--verbose	詳細模式

使用範例

# 查詢
mongots -u "mongodb://..." -q "db.users.find()"
mongots -q "db.users.findOne({name: 'test'})"

# 新增（需 --allow-write）
mongots --allow-write -q "db.users.insertOne({name: 'test'})"

# 更新
mongots --allow-write -q "db.users.updateOne({_id: '...'}, {\$set: {name: 'new'}})"

# 刪除
mongots --allow-write -q "db.users.deleteOne({_id: '...'})"

# 聚合
mongots -q "db.orders.aggregate([{\$group: {_id: '\$status'}}])"

# 管理
mongots -q "show dbs"
mongots -q "show collections"
mongots -q "db.stats()"

連線設定

優先順序：CLI 參數 > 環境變數 > 設定檔

首次使用

若不知道連線資訊，使用 AskUserQuestion 詢問以下環境變數，並詢問是否寫入 .env：

變數	說明	範例
MONGO_TS_URI	MongoDB 連線字串（必填）	mongodb://localhost:27017/mydb
MONGO_TS_DB	預設資料庫（選填，覆蓋 URI）	mydb
MONGO_TS_FORMAT	輸出格式（選填）	table/json/csv/yaml
MONGO_TS_ALLOW_WRITE	允許寫入（選填）	true

設定方式

1. CLI 參數：-u "mongodb://localhost:27017"
2. 環境變數：.env 檔案或系統環境變數
3. 設定檔：~/.mongots/config.json

{
  "uri": "mongodb://localhost:27017",
  "defaultDb": "mydb",
  "format": "table",
  "allowWrite": false
}

支援的查詢語法

類型	範例
查詢	db.coll.find({}), db.coll.findOne({})
新增	db.coll.insertOne({}), db.coll.insertMany([])
更新	db.coll.updateOne({}, {}), db.coll.updateMany({}, {})
刪除	db.coll.deleteOne({}), db.coll.deleteMany({})
聚合	db.coll.aggregate([])
計數	db.coll.countDocuments({})
索引	db.coll.createIndex({}), db.coll.getIndexes()
管理	show dbs, show collections, db.stats()

唯讀模式（預設）

預設為唯讀模式，使用 --allow-write 啟用寫入操作。

唯讀允許：find, findOne, countDocuments, aggregate（無 $out/$merge）, getIndexes, stats, show dbs/collections

需要 --allow-write：insert*, update*, delete*, drop*, createIndex, dropIndex

輸出格式

Table（預設，Markdown 格式）

_id                      | name  | age
------------------------ | ----- | ---
507f1f77bcf86cd799439011 | Alice | 25
507f1f77bcf86cd799439012 | Bob   | 30

JSON

mongots -q "db.users.find()" -f json

CSV

mongots -q "db.users.find()" -f csv

YAML

mongots -q "db.users.find()" -f yaml