mongo-ts

vivalalova's avatarfrom vivalalova

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

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 16, 2025
[Databases and Warehouses]

When & Why to Use This Skill

The mongo-ts skill is a powerful MongoDB CLI integration that enables direct execution of MongoDB query syntax within the Claude environment. It supports a full range of database operations including CRUD, complex aggregations, and index management. Designed with production safety in mind, it features a default read-only mode to prevent accidental data modification while providing flexible output formats like Table, JSON, CSV, and YAML for optimal data visualization and reporting.

Use Cases

  • Ad-hoc Data Exploration: Quickly query and inspect MongoDB documents to verify data structures or content without leaving the chat interface.
  • Safe Production Debugging: Use the default read-only mode to safely investigate live data issues in production environments without risk of data loss.
  • Data Transformation and Aggregation: Execute multi-stage aggregation pipelines to generate summaries, statistics, or transformed datasets for analysis.
  • Database Administration: Manage collection indexes, monitor database statistics, and list available databases or collections for maintenance tasks.
  • Automated Data Exporting: Run queries and export results directly into CSV or JSON formats for use in external reports or spreadsheets.
namemongo-ts
descriptionMongoDB 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