# sally-mcp ## 基本信息 - Slug: `sally-labs-sally-mcp` - Source: modelscope - Publisher: @sally-labs/sally-mcp - Categories: health-and-wellness / blockchain / web3 - Hosted: No - License: MIT License - Source URL: https://www.modelscope.cn/mcp/servers/@sally-labs/sally-mcp ## 简介 暂无描述。 ## 安装提示 ```bash MCP Client (Claude, Cursor) Sally MCP Server x402 Payment (Local/Smithery) Protocol Sally API (Metabolic Health) ``` ## MCP Server 详情
# Sally MCP Server ### AI-Powered Metabolic Health Assistant with Blockchain-Based Payments **Connect to Sally through the Model Context Protocol (MCP) with x402 payment infrastructure** [![Smithery](https://img.shields.io/badge/Smithery-Compatible-blue)](https://smithery.ai/server/@sally-labs/sally-ai-mcp) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue)](https://www.typescriptlang.org/) [![MCP](https://img.shields.io/badge/MCP-1.9-green)](https://modelcontextprotocol.io) [Quick Start](#-quick-start) [Installation](#-installation) [Usage](#-usage) [API Reference](#-api-reference) [Deployment](#-deployment)
--- ## What is Sally MCP Server? Sally MCP Server is a **Model Context Protocol (MCP)** server that enables AI assistants like Claude Desktop, Cursor, and other MCP-compatible clients to interact with **Sally**, an AI-powered metabolic health assistant. Built with the **x402 blockchain-based payment protocol**, Sally MCP ensures secure, transparent micropayments for each AI interaction while keeping your private keys and data entirely on your local machine. ### Key Features - **Metabolic Health Expertise**: Chat with Sally about nutrition, metabolism, and health optimization - **x402 Payment Integration**: Automatic blockchain-based micropayments for API usage - **Multi-Transport Support**: Deploy locally (stdio) or hosted (HTTP/SSE via Smithery) - **Security First**: Private keys never leave your device - **MCP Compatible**: Works with Claude Desktop, Cursor, and any MCP-compatible client - **Type-Safe**: Built with TypeScript and Zod schemas for reliability - **Production Ready**: Dockerized and ready for Smithery cloud deployment ### Architecture ``` MCP Client (Claude, Cursor) Sally MCP Server x402 Payment (Local/Smithery) Protocol Sally API (Metabolic Health) ``` --- ## Quick Start Get up and running in 5 minutes: ### Prerequisites - Node.js 18+ and pnpm installed - An MCP-compatible client ([Claude Desktop](https://claude.ai/download), [Cursor](https://cursor.sh/), etc.) - A dedicated crypto wallet with small funds for x402 transactions ### 1. Install via Smithery (Recommended) The easiest way to use Sally MCP is through [Smithery](https://smithery.ai): ```bash npx @smithery/cli install @sally-labs/sally-ai-mcp --client claude ``` ### 2. Install Locally ```bash # Clone and setup git clone https://github.com/sally-labs/sally-mcp.git cd sally-mcp pnpm install pnpm build ``` ### 3. Configure Your MCP Client Add to your MCP client configuration (e.g., `claude_desktop_config.json`): ```json { "mcpServers": { "sally": { "command": "node", "args": ["/path/to/sally-mcp/dist/index.js"], "env": { "PRIVATE_KEY": "0x...", "TRANSPORT_MODE": "stdio" } } } } ``` ### 4. Test the Connection Restart your MCP client and try: ``` "Use the chat-with-sally tool to ask: What are the benefits of intermittent fasting?" ``` --- ## Installation ### Option A: Deploy with Smithery (Cloud Hosted) Smithery provides managed hosting for MCP servers with automatic scaling and updates. ```bash # Install Smithery CLI npm install -g @smithery/cli # Install Sally MCP npx @smithery/cli install @sally-labs/sally-ai-mcp --client claude ``` Configure via Smithery dashboard: - **Private Key**: Your dedicated wallet's private key (with 0x prefix) - The server will be automatically available in your MCP clients ### Option B: Local Development Setup #### Step 1: Create a Dedicated Wallet ** Security Critical**: Never use your main wallet for MCP integrations. 1. Create a new wallet using MetaMask, Coinbase Wallet, or similar 2. Transfer a small amount of funds (e.g., $5-10 worth of crypto) 3. Export the private key (it should start with `0x`) 4. Store it securely #### Step 2: Clone and Install ```bash # Clone repository git clone https://github.com/sally-labs/sally-mcp.git cd sally-mcp # Install dependencies pnpm install ``` #### Step 3: Configure Environment Create a `.env` file: ```bash PRIVATE_KEY=0x... TRANSPORT_MODE=stdio ``` #### Step 4: Build and Run ```bash # Build TypeScript pnpm build # Run the server node dist/index.js ``` --- ## MCP Client Configuration ### Claude Desktop 1. Open Claude Desktop Settings 2. Navigate to **Developer Edit Config** 3. Edit `claude_desktop_config.json`: ```json { "mcpServers": { "sally": { "command": "node", "args": ["/Users/yourname/code/sally-mcp/dist/index.js"], "env": { "PRIVATE_KEY": "0x...", "TRANSPORT_MODE": "stdio" } } } } ``` 4. Restart Claude Desktop 5. The Sally tools should appear automatically ### Cursor 1. Open Cursor Settings 2. Navigate to **Features MCP Servers** 3. Add server configuration: ```json { "sally": { "command": "node", "args": ["/path/to/sally-mcp/dist/index.js"], "env": { "PRIVATE_KEY": "0x...", "TRANSPORT_MODE": "stdio" } } } ``` 4. Restart Cursor ### Other MCP Clients Refer to your client's documentation for custom MCP server configuration. You'll need: - **Command**: `node` - **Args**: `["/path/to/sally-mcp/dist/index.js"]` - **Environment Variables**: `PRIVATE_KEY`, `TRANSPORT_MODE=stdio` --- ## Usage ### Basic Interaction Once configured, interact with Sally naturally through your MCP client: ``` "Use chat-with-sally to ask: What foods help stabilize blood sugar?" ``` ``` "Ask Sally about the relationship between sleep and metabolic health" ``` ``` "Use Sally to create a meal plan for someone with insulin resistance" ``` ### Available Tools #### chat-with-sally Chat with Sally about metabolic health topics. **Parameters:** - `message` (string, required)…