cli

Install, manage and develop MCP servers

GitHub Stars

391

User Rating

Not Rated

Favorites

0

Views

23

Forks

58

Issues

200

Installation
Difficulty
Intermediate
Estimated Time
10-20 minutes
Requirements
Node.js version 18 or above

Installation

Installation

Prerequisites

Please specify required software and versions:
Node.js: 18.0.0 or higher

Installation Steps

1. Clone Repository

bash
git clone https://github.com/smithery-ai/cli
cd cli

2. Install Dependencies

bash
npm install

3. Start Server

bash
npx @smithery/cli dev

Troubleshooting

Common Issues

Issue: Server won't start Solution: Check Node.js version and reinstall dependencies. Issue: Command not recognized Solution: Ensure you are executing commands using npx.

Configuration

Configuration

Basic Configuration

Claude Desktop Setup

Edit ~/.config/claude-desktop/claude_desktop_config.json (macOS/Linux) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
json
{
  "mcpServers": {
    "tool-name": {
      "command": "npx",
      "args": ["-y", "@smithery/cli"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

Environment Variables

Set the following environment variables as needed:
bash
export API_KEY="your-api-key"

Configuration Example

Basic Configuration

json
{
  "mcpServers": {
    "example-mcp": {
      "command": "npx",
      "args": ["@smithery/cli", "dev"],
      "env": {
        "PORT": "3000"
      }
    }
  }
}

Examples

Examples

Basic Usage

Here are basic usage examples for the MCP server:

Install Server

bash
npx @smithery/cli install mcp-obsidian --client claude

Run Server

bash
npx @smithery/cli run mcp-obsidian --config '{"key":"value"}'

Start Development Server

bash
npx @smithery/cli dev

Production Build

bash
npx @smithery/cli build --out dist/server.cjs

Use Cases

Install an MCP server and integrate it with a specific AI client.
Start an MCP server in a development environment and reflect changes in real-time.
Inspect the configuration of a specific server and modify it as needed.
Build an MCP server for production and deploy it.