| Name | mcpstore-cli JSON |
| Version |
0.1.9
JSON |
| download |
| home_page | None |
| Summary | Python MCP server registry and proxy for AI agents |
| upload_time | 2025-07-16 15:52:17 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | None |
| keywords |
agents
ai
mcp
proxy
registry
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# 🚀 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.
Raw data
{
"_id": null,
"home_page": null,
"name": "mcpstore-cli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "agents, ai, mcp, proxy, registry",
"author": null,
"author_email": "xray918 <xray918@github.com>",
"download_url": "https://files.pythonhosted.org/packages/9a/c9/6541eb69c02eff83055a968c58f514237a7ef69d5215f06d1f2a2e7c012e/mcpstore_cli-0.1.9.tar.gz",
"platform": null,
"description": "# \ud83d\ude80 mcpstore-cli\n\n**English | [\u4e2d\u6587\u8bf4\u660e](#\u4e2d\u6587\u8bf4\u660e)**\n\n---\n\n## Overview\n\n`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.\n\n- \ud83d\udd0d **Registry Search**: Discover MCP servers from multiple sources\n- \ud83d\udce6 **One-Click Install**: Install and configure servers for various clients\n- \ud83d\udee0\ufe0f **Proxy Mode**: Run as a transparent MCP proxy\n- \ud83c\udf10 **Multi-Source**: Supports PyPI, NPM, GitHub, Docker\n- \ud83c\udfa8 **Rich CLI**: Beautiful, interactive command line interface\n\n---\n\n## Quick Start\n\n### Installation\n\n```bash\npip install mcpstore-cli\n```\n\nOr use [uv](https://github.com/astral-sh/uv):\n\n```bash\nuv pip install mcpstore-cli\n```\n\n### Basic Usage\n\n#### Search for MCP servers\n```bash\nmcpstore-cli search weather\n```\n\n#### Show server info\n```bash\nmcpstore-cli info @turkyden/weather\n```\n\n#### Install server to client\n```bash\nmcpstore-cli install @turkyden/weather --client cursor --key <your-api-key>\n```\n\n#### List installed servers\n```bash\nmcpstore-cli list --client cursor\n```\n\n#### Run as MCP proxy\n```bash\nmcpstore-cli run @turkyden/weather --key <your-api-key>\n```\n\n---\n\n## Configuration\n\n- **Config file**: `~/.mcpstore/config.toml`\n- **Environment variables**: `MCPSTORE_REGISTRY_URL`, `MCPSTORE_API_KEY`, etc.\n- **Clients supported**: Cursor, Claude Desktop, VS Code, Custom\n\nExample config:\n```toml\n[registry]\nurl = \"https://registry.mcpstore.dev\"\napi_key = \"your-api-key\"\n\n[proxy]\nhost = \"127.0.0.1\"\nport = 8080\n```\n\n---\n\n## Architecture\n\n- **Proxy Mode**: Acts as a transparent proxy between MCP client and server\n- **Registry**: Aggregates servers from PyPI, NPM, GitHub, Docker\n- **CLI**: Rich, interactive, multi-language\n\n---\n\n## FAQ\n\n**Q: How to publish my own MCP server?**\nA: Publish to PyPI/NPM/GitHub/Docker, then register via `mcpstore-cli`.\n\n**Q: How to use with Cursor/Claude/VSCode?**\nA: Use `install` command to configure the client automatically.\n\n**Q: How to update?**\nA: `pip install --upgrade mcpstore-cli` or `uv pip install --upgrade mcpstore-cli`\n\n---\n\n# \u4e2d\u6587\u8bf4\u660e\n\n## \u7b80\u4ecb\n\n`mcpstore-cli` \u662f\u4e00\u6b3e\u9762\u5411 AI \u667a\u80fd\u4f53\u5f00\u53d1\u8005\u7684 Python \u547d\u4ee4\u884c\u5de5\u5177\uff0c\u652f\u6301 MCP \u670d\u52a1\u5668\u7684\u6ce8\u518c\u3001\u53d1\u73b0\u3001\u5b89\u88c5\u3001\u914d\u7f6e\u548c\u4ee3\u7406\u3002\u652f\u6301 PyPI\u3001NPM\u3001GitHub\u3001Docker \u591a\u6e90\u670d\u52a1\u5668\u3002\n\n- \ud83d\udd0d **\u6ce8\u518c\u8868\u641c\u7d22**\uff1a\u591a\u6e90\u53d1\u73b0 MCP \u670d\u52a1\u5668\n- \ud83d\udce6 **\u4e00\u952e\u5b89\u88c5**\uff1a\u81ea\u52a8\u5b89\u88c5\u914d\u7f6e\u5230\u5404\u7c7b\u5ba2\u6237\u7aef\n- \ud83d\udee0\ufe0f **\u4ee3\u7406\u6a21\u5f0f**\uff1a\u900f\u660e\u4ee3\u7406 MCP \u901a\u4fe1\n- \ud83c\udf10 **\u591a\u6e90\u652f\u6301**\uff1aPyPI/NPM/GitHub/Docker\n- \ud83c\udfa8 **\u7f8e\u89c2 CLI**\uff1a\u4ea4\u4e92\u5f0f\u547d\u4ee4\u884c\u4f53\u9a8c\n\n---\n\n## \u5feb\u901f\u5f00\u59cb\n\n### \u5b89\u88c5\n\n```bash\npip install mcpstore-cli\n```\n\n\u6216\u4f7f\u7528 uv\uff1a\n\n```bash\nuv pip install mcpstore-cli\n```\n\n### \u57fa\u672c\u7528\u6cd5\n\n#### \u641c\u7d22\u670d\u52a1\u5668\n```bash\nmcpstore-cli search weather\n```\n\n#### \u67e5\u770b\u670d\u52a1\u5668\u4fe1\u606f\n```bash\nmcpstore-cli info @turkyden/weather\n```\n\n#### \u5b89\u88c5\u670d\u52a1\u5668\u5230\u5ba2\u6237\u7aef\n```bash\nmcpstore-cli install @turkyden/weather --client cursor --key <\u4f60\u7684API\u5bc6\u94a5>\n```\n\n#### \u5217\u51fa\u5df2\u5b89\u88c5\u670d\u52a1\u5668\n```bash\nmcpstore-cli list --client cursor\n```\n\n#### \u4ee3\u7406\u8fd0\u884c\u670d\u52a1\u5668\n```bash\nmcpstore-cli run @turkyden/weather --key <\u4f60\u7684API\u5bc6\u94a5>\n```\n\n---\n\n## \u914d\u7f6e\n\n- **\u914d\u7f6e\u6587\u4ef6**\uff1a`~/.mcpstore/config.toml`\n- **\u73af\u5883\u53d8\u91cf**\uff1a`MCPSTORE_REGISTRY_URL`\u3001`MCPSTORE_API_KEY` \u7b49\n- **\u652f\u6301\u5ba2\u6237\u7aef**\uff1aCursor\u3001Claude Desktop\u3001VS Code\u3001\u81ea\u5b9a\u4e49\n\n\u914d\u7f6e\u793a\u4f8b\uff1a\n```toml\n[registry]\nurl = \"https://registry.mcpstore.dev\"\napi_key = \"your-api-key\"\n\n[proxy]\nhost = \"127.0.0.1\"\nport = 8080\n```\n\n---\n\n## \u67b6\u6784\u8bf4\u660e\n\n- **\u4ee3\u7406\u6a21\u5f0f**\uff1a\u4f5c\u4e3a MCP \u5ba2\u6237\u7aef\u4e0e\u670d\u52a1\u5668\u4e4b\u95f4\u7684\u900f\u660e\u4ee3\u7406\n- **\u6ce8\u518c\u8868\u805a\u5408**\uff1a\u652f\u6301 PyPI/NPM/GitHub/Docker \u591a\u6e90\n- **\u547d\u4ee4\u884c\u4ea4\u4e92**\uff1a\u652f\u6301\u4e2d\u82f1\u6587\n\n---\n\n## \u5e38\u89c1\u95ee\u9898\n\n**Q: \u5982\u4f55\u53d1\u5e03\u81ea\u5df1\u7684 MCP \u670d\u52a1\u5668\uff1f**\nA: \u53d1\u5e03\u5230 PyPI/NPM/GitHub/Docker \u540e\uff0c\u7528 mcpstore-cli \u6ce8\u518c\u3002\n\n**Q: \u5982\u4f55\u4e0e Cursor/Claude/VSCode \u914d\u5408\uff1f**\nA: \u7528 `install` \u547d\u4ee4\u81ea\u52a8\u914d\u7f6e\u3002\n\n**Q: \u5982\u4f55\u5347\u7ea7\uff1f**\nA: `pip install --upgrade mcpstore-cli` \u6216 `uv pip install --upgrade mcpstore-cli`\n\n---\n\n## \u8d21\u732e\u4e0e\u652f\u6301\n\n- GitHub: https://github.com/xray918/mcpstore-cli\n- Issues: https://github.com/xray918/mcpstore-cli/issues\n\n---\n\n> mcpstore-cli \u00a9 2024 xray918. MIT License. ",
"bugtrack_url": null,
"license": null,
"summary": "Python MCP server registry and proxy for AI agents",
"version": "0.1.9",
"project_urls": {
"Documentation": "https://github.com/xray918/agentrix",
"Issues": "https://github.com/xray918/agentrix/issues",
"Repository": "https://github.com/xray918/agentrix",
"Source": "https://github.com/xray918/agentrix"
},
"split_keywords": [
"agents",
" ai",
" mcp",
" proxy",
" registry"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "dc1dfe9063e09498d4ddceed88ae76e48b994b18af10388a993979903d0b688e",
"md5": "46b6c59fb8854917ae9bd120f3a877ad",
"sha256": "30af6c19e0d823be2ee1a4c399c200e7c1c45f2cf37dcb25eab4854f316b456c"
},
"downloads": -1,
"filename": "mcpstore_cli-0.1.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "46b6c59fb8854917ae9bd120f3a877ad",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 39289,
"upload_time": "2025-07-16T15:52:14",
"upload_time_iso_8601": "2025-07-16T15:52:14.564513Z",
"url": "https://files.pythonhosted.org/packages/dc/1d/fe9063e09498d4ddceed88ae76e48b994b18af10388a993979903d0b688e/mcpstore_cli-0.1.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "9ac96541eb69c02eff83055a968c58f514237a7ef69d5215f06d1f2a2e7c012e",
"md5": "54cecbc9698bd13000e704a554014a6f",
"sha256": "941d70fff5097df7583c36e451360bf43c116c1fae6f015e9990a063e6999063"
},
"downloads": -1,
"filename": "mcpstore_cli-0.1.9.tar.gz",
"has_sig": false,
"md5_digest": "54cecbc9698bd13000e704a554014a6f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 101533,
"upload_time": "2025-07-16T15:52:17",
"upload_time_iso_8601": "2025-07-16T15:52:17.700449Z",
"url": "https://files.pythonhosted.org/packages/9a/c9/6541eb69c02eff83055a968c58f514237a7ef69d5215f06d1f2a2e7c012e/mcpstore_cli-0.1.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-16 15:52:17",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "xray918",
"github_project": "agentrix",
"github_not_found": true,
"lcname": "mcpstore-cli"
}
