syncable-cli

This MCP server provides a Rust-based local server with two transport modes: stdio (mcp-stdio) and SSE (mcp-sse). On startup, it exposes tools such as about_info, analysis_scan, security_scan, and dependency_scan. You can interact with these tools programmatically via the MCP client interface, or run the binaries directly for manual testing. Use the stdio mode for a traditional intra-process style IPC, or SSE for a server-sent events style transport. The README demonstrates building, testing, and running a Python client against these tools to verify capabilities like retrieving about information and performing scans on a project directory.

Prerequisites:

• Rust 1.70+ (install via rustup: rustup update)
• Python 3.8+ (for client testing)
• uv (for Python client tooling and testing, e.g., brew install uv on macOS)

Installation steps:

1. Clone the repository and enter the project:

git clone https://github.com/your-org/syncable-cli-mcp-server.git
cd syncable-cli-mcp-server

2. Build the project (debug by default):

# Debug build
cargo build

3. Build for release (optional):

cargo build --release

4. Run the servers:

# stdio mode
cargo run --bin mcp-stdio

# In another terminal, for SSE mode
cargo run --bin mcp-sse

Notes:

• Prerequisites emphasize Rust for building the server and Python/uv for client-side testing. The server provides two transport modes (stdio and SSE) which are useful for different integration scenarios.
• Common tools exposed include about_info, analysis_scan, security_scan, and dependency_scan. Use the provided Python client sample in the README to exercise these tools programmatically.
• For debugging, enable Rust logging via RUST_LOG=debug when launching the stdio server. If port or binary issues arise, ensure you built the binaries in the expected path and that the correct binary name is used for the chosen transport mode.
• Release automation is handled with release-plz in this project; ensure dependencies are installed and tokens configured if you plan to publish.