一个高性能的Rust库和CLI，支持集成的MCP（模型上下文协议）服务器支持，适用于AI/LLM环境。

** 📦 版本 1.0.0 - 生产准备！**

✨ 特色

• 🚀 高性能：采用Rust制造，以实现最高速度和可靠性
• 🔧 CLI 工具：用于管理 Things 3 数据的命令行界面
• 🤖 MCP 集成：集成 MCP 服务器，用于 AI/LLM 集成
• 📊 安全集成：通过异步SQLx读取，通过AppleScript进行变异（根据CulturedCode指南）
• 🏗️ Moon Workspace：有组织的单仓库，使用 Moon 构建系统
• 🧪 经过充分测试：全面的测试套件和基准测试
• 📈 性能监控：内置指标和系统监控
• 💾 缓存层：使用 Moka 实现高性能缓存
• 🔄 备份与恢复：带元数据的完整备份系统
• 📤 数据导出：多种格式（JSON、CSV、OPML、Markdown）
• 🔧 高级MCP工具：17个AI/LLM集成工具
• ⚡ 异步数据库：基于SQLx的异步数据库操作，具备线程安全
• 🌐 Web 服务器：健康检查和监控仪表盘服务器

🚀 安装

自制软件（macOS）

🦀 Rust Things

A high-performance Rust library and CLI for Things 3 integration with integrated MCP (Model Context Protocol) server support for AI/LLM environments.

📦 Version 1.0.0 - Production Ready!

✨ Features

• 🚀 High Performance: Built with Rust for maximum speed and reliability
• 🔧 CLI Tool: Command-line interface for managing Things 3 data
• 🤖 MCP Integration: Integrated MCP server for AI/LLM integration
• 📊 Safe Integration: Reads via async SQLx, mutations via AppleScript (per CulturedCode guidelines)
• 🏗️ Moon Workspace: Organized monorepo with Moon build system
• 🧪 Well Tested: Comprehensive test suite and benchmarks
• 📈 Performance Monitoring: Built-in metrics and system monitoring
• 💾 Caching Layer: High-performance caching with Moka
• 🔄 Backup & Restore: Complete backup system with metadata
• 📤 Data Export: Multiple formats (JSON, CSV, OPML, Markdown)
• 🔧 Advanced MCP Tools: 17 tools for AI/LLM integration
• ⚡ Async Database: SQLx-powered async database operations with thread safety
• 🌐 Web Servers: Health check and monitoring dashboard servers

🚀 Installation

Homebrew (macOS)

# Add the tap (when available)
brew tap GarthDB/rust-things3

# Install
brew install things3-cli

Cargo (Rust)

# Install from crates.io (when published)
cargo install things3-cli --features mcp-server

# Or install from source
cargo install --path apps/things3-cli --features mcp-server

After upgrading: cargo install replaces the binary on disk, but any running MCP server process still uses the old in-memory binary. Restart the process (or your editor/agent host) after upgrading so the new version is loaded. You can verify the running version with things3 --version.

From Source

git clone https://github.com/GarthDB/rust-things3
cd rust-things3
cargo build --release

# Add to PATH
export PATH="$PWD/target/release:$PATH"

Using Moon (Development)

# Install Moon if you haven't already
curl -fsSL https://moonrepo.dev/install | bash

# Clone and setup
git clone https://github.com/GarthDB/rust-things3
cd rust-things3
moon run :dev-pipeline

⚙️ Feature Flags