Metadata-Version: 2.4
Name: mcpstore-cli
Version: 0.1.15
Summary: Python MCP server registry and proxy for AI agents
Project-URL: Documentation, https://github.com/xray918/agentrix
Project-URL: Issues, https://github.com/xray918/agentrix/issues
Project-URL: Source, https://github.com/xray918/agentrix
Project-URL: Repository, https://github.com/xray918/agentrix
Author-email: xray918 <xray918@github.com>
License-Expression: MIT
License-File: LICENSE
Keywords: agents,ai,mcp,proxy,registry
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: aiofiles>=23.0.0
Requires-Dist: anyio>=4.0.0
Requires-Dist: click>=8.1.0
Requires-Dist: httpx>=0.25.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: packaging>=23.0
Requires-Dist: pydantic-settings>=2.1.0
Requires-Dist: pydantic>=2.5.0
Requires-Dist: rich>=13.0.0
Requires-Dist: tomlkit>=0.12.0
Requires-Dist: typer>=0.12.0
Requires-Dist: uvloop>=0.19.0; sys_platform != 'win32'
Provides-Extra: all
Requires-Dist: agentrix[dev,server]; extra == 'all'
Provides-Extra: dev
Requires-Dist: black>=23.0.0; extra == 'dev'
Requires-Dist: mypy>=1.7.0; extra == 'dev'
Requires-Dist: pre-commit>=3.0.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Provides-Extra: server
Requires-Dist: fastapi>=0.104.0; extra == 'server'
Requires-Dist: python-multipart>=0.0.6; extra == 'server'
Requires-Dist: uvicorn>=0.24.0; extra == 'server'
Description-Content-Type: text/markdown

# 🚀 mcpstore-cli

**English | [中文说明](#中文说明)**

---

## Overview

`mcpstore-cli` is a powerful Python CLI tool for managing and proxying Model Context Protocol (MCP) servers. It provides a unified registry, installation, configuration, and proxy solution for AI agent developers. Supports MCP servers from PyPI, NPM, GitHub, Docker, and more.

- 🔍 **Registry Search**: Discover MCP servers from multiple sources
- 📦 **One-Click Install**: Install and configure servers for various clients
- 🛠️ **Proxy Mode**: Run as a transparent MCP proxy
- 🌐 **Multi-Source**: Supports PyPI, NPM, GitHub, Docker
- 🎨 **Rich CLI**: Beautiful, interactive command line interface

---

## Quick Start

### Installation

```bash
pip install mcpstore-cli
```

Or use [uv](https://github.com/astral-sh/uv):

```bash
uv pip install mcpstore-cli
```

### Basic Usage

#### Search for MCP servers
```bash
mcpstore-cli search weather
```

#### Show server info
```bash
mcpstore-cli info @turkyden/weather
```

#### Install server to client
```bash
mcpstore-cli install @turkyden/weather --client cursor --key <your-api-key>
```

#### List installed servers
```bash
mcpstore-cli list --client cursor
```

#### Run as MCP proxy
```bash
mcpstore-cli run @turkyden/weather --key <your-api-key>
```

---

## Configuration

- **Config file**: `~/.mcpstore/config.toml`
- **Environment variables**: `MCPSTORE_REGISTRY_URL`, `MCPSTORE_API_KEY`, etc.
- **Clients supported**: Cursor, Claude Desktop, VS Code, Custom

Example config:
```toml
[registry]
url = "https://registry.mcpstore.dev"
api_key = "your-api-key"

[proxy]
host = "127.0.0.1"
port = 8080
```

---

## Architecture

- **Proxy Mode**: Acts as a transparent proxy between MCP client and server
- **Registry**: Aggregates servers from PyPI, NPM, GitHub, Docker
- **CLI**: Rich, interactive, multi-language

---

## FAQ

**Q: How to publish my own MCP server?**
A: Publish to PyPI/NPM/GitHub/Docker, then register via `mcpstore-cli`.

**Q: How to use with Cursor/Claude/VSCode?**
A: Use `install` command to configure the client automatically.

**Q: How to update?**
A: `pip install --upgrade mcpstore-cli` or `uv pip install --upgrade mcpstore-cli`

---

# 中文说明

## 简介

`mcpstore-cli` 是一款面向 AI 智能体开发者的 Python 命令行工具，支持 MCP 服务器的注册、发现、安装、配置和代理。支持 PyPI、NPM、GitHub、Docker 多源服务器。

- 🔍 **注册表搜索**：多源发现 MCP 服务器
- 📦 **一键安装**：自动安装配置到各类客户端
- 🛠️ **代理模式**：透明代理 MCP 通信
- 🌐 **多源支持**：PyPI/NPM/GitHub/Docker
- 🎨 **美观 CLI**：交互式命令行体验

---

## 快速开始

### 安装

```bash
pip install mcpstore-cli
```

或使用 uv：

```bash
uv pip install mcpstore-cli
```

### 基本用法

#### 搜索服务器
```bash
mcpstore-cli search weather
```

#### 查看服务器信息
```bash
mcpstore-cli info @turkyden/weather
```

#### 安装服务器到客户端
```bash
mcpstore-cli install @turkyden/weather --client cursor --key <你的API密钥>
```

#### 列出已安装服务器
```bash
mcpstore-cli list --client cursor
```

#### 代理运行服务器
```bash
mcpstore-cli run @turkyden/weather --key <你的API密钥>
```

---

## 配置

- **配置文件**：`~/.mcpstore/config.toml`
- **环境变量**：`MCPSTORE_REGISTRY_URL`、`MCPSTORE_API_KEY` 等
- **支持客户端**：Cursor、Claude Desktop、VS Code、自定义

配置示例：
```toml
[registry]
url = "https://registry.mcpstore.dev"
api_key = "your-api-key"

[proxy]
host = "127.0.0.1"
port = 8080
```

---

## 架构说明

- **代理模式**：作为 MCP 客户端与服务器之间的透明代理
- **注册表聚合**：支持 PyPI/NPM/GitHub/Docker 多源
- **命令行交互**：支持中英文

---

## 常见问题

**Q: 如何发布自己的 MCP 服务器？**
A: 发布到 PyPI/NPM/GitHub/Docker 后，用 mcpstore-cli 注册。

**Q: 如何与 Cursor/Claude/VSCode 配合？**
A: 用 `install` 命令自动配置。

**Q: 如何升级？**
A: `pip install --upgrade mcpstore-cli` 或 `uv pip install --upgrade mcpstore-cli`

---

## 贡献与支持

- GitHub: https://github.com/xray918/mcpstore-cli
- Issues: https://github.com/xray918/mcpstore-cli/issues

---

> mcpstore-cli © 2024 xray918. MIT License. 