semvec/pypi-packages huggingface dataset:
fserver 0.2
File Sharing Server implemented with flask and gevent
License: MIT

# fserver

File Sharing Server implemented with flask and gevent


### Install or Upgrade 

```shell
$ pip install fserver -U
```


### Usage 

```text
usage: fserver [-h] [-d] [-u] [-o] [-i IP] [-p PORT] [-r PATH] [-a PATH [PATH ...]] [-b PATH [PATH ...]] [-s STRING]
               [-v] [-g] [--git_path GIT_PATH] [--username USERNAME] [--password PASSWORD]

optional arguments:
  -h, --help            show this help message and exit
  -d, --debug           run with debug mode
  -u, --upload          run with upload file function
  -o, --override        override mode for upload file
  -i IP, --ip IP        ip address for listening, default 0.0.0.0
  -p PORT, --port PORT  port for listening, default 2000
  -r PATH, --root PATH  root path for server, default current path
  -a PATH [PATH ...], --allow PATH [PATH ...]
                        run with allow_list. Only [PATH ...] will be accessed
  -b PATH [PATH ...], --block PATH [PATH ...]
                        run with block_list. [PATH ...] will not be accessed
  -s STRING, --string STRING
                        share string only
  -v, --version         print version info
  -g, --git             open git http service for projections in root
  --git_path GIT_PATH   path for git executable file
  --username USERNAME   username for git authentication
  --password PASSWORD   password for git authentication
```

### Matching Rule

argument for `-a` and `-b` support wildcards "\*" and "\*\*". 

"*" match multiple arbitrary character in a file name or directory name.

"**" match arbitrary multi-Level directories.

**example:** 

|          | */a2 | *1/a2 | b1/* | **/an | b1/** |
| -------- | ---- | ----- | ---- | ----- | ----- |
| a1/a2    | yes  | yes   |      |       |       |
| a1/an    |      |       |      | yes   |       |
| a1/a2/an |      |       |      | yes   |       |
| b1/a2    | yes  | yes   | yes  |       | yes   |
| b1/a2/an |      |       |      | yes   | yes   |




### License
[MIT](https://github.com/Carrotor116/fserver/blob/master/LICENSE)
vcursor-cli 1.0.27
VCursor SDK & CLI - Generate videos from text, images, and URLs using AI
License: MIT
Requires Python: >=3.9
Keywords: video, ai, generation, cli, vcursor, sdk

# VCursor Python SDK & CLI

Generate videos from text, images, and URLs using AI.

## Installation

```bash
pip install vcursor-cli
```

## Quick Start

### As a library (embedded in code)

```python
from vcursor import VCursor

client = VCursor(api_key="vk-...")

# Submit a video generation task
resp = client.submit("a cat playing piano in a jazz club")

# Wait for completion with progress callback
result = client.wait_for_completion(
    resp.task_id,
    on_progress=lambda p: print(f"{p.data.progress}%")
)

print(result.data.products.url)
```

### Async usage

```python
import asyncio
from vcursor import VCursorAsync

async def main():
    async with VCursorAsync(api_key="vk-...") as client:
        resp = await client.submit("sunset timelapse over mountains")
        result = await client.wait_for_completion(resp.task_id)
        print(result.data.products.url)

asyncio.run(main())
```

### Concurrency limiting

The server enforces per-user rate limits based on subscription tier:

| Tier | Standard Requests | Agent Requests | Window    |
|------|-------------------|----------------|-----------|
| Free | 3                 | 1              | Lifetime  |
| Pro  | 30/hr             | 5/hr           | Rolling 1h|
| Plus | 120/hr            | 15/hr          | Rolling 1h|

```python
# Check current rate limit status
status = client.check_concurrency("standard")
print(f"Standard: {status.summary['standard'].used}/{status.summary['standard'].limit}")
print(f"Agent:    {status.summary['agent'].used}/{status.summary['agent'].limit}")

# Client-side limit (capped at server limit)
client = VCursor(api_key="vk-...", max_concurrency=10)
```

### As a CLI

```bash
# Authenticate
vcursor login

# Generate a video
vcursor generate "a cat playing piano"

# Agent mode
vcursor generate --agent "create a 30s commercial"

# Check concurrency status
vcursor concurrency

# With concurrency limit
vcursor generate --max-concurrency 2 "sunset timelapse"
```

## API Reference

### `VCursor` / `VCursorAsync`

| Method                    | Description                            |
|---------------------------|----------------------------------------|
| `submit(prompt, **kw)`   | Submit a standard video generation task |
| `get_progress(task_id)`  | Get task progress                      |
| `wait_for_completion()`  | Poll until task completes              |
| `cancel_task(task_id)`   | Cancel a running task                  |
| `submit_agent(message)`  | Submit an agent mode task              |
| `get_agent_progress()`   | Get agent task progress                |
| `wait_for_agent_completion()` | Poll until agent task completes   |
| `check_concurrency()`    | Check concurrency limit status         |

## Configuration

Config is stored in `~/.vcursor/config.json` (shared with the Node.js CLI).

Environment variables:
- `VCURSOR_API_KEY` - API key
- `VCURSOR_SERVER` - Server URL

## License

MIT
mcp-nacos-helper 1.0.3
基于 FastMCP 的 Nacos 配置读取与服务状态分析工具。
License: MIT
Requires Python: >=3.8
Keywords: mcp, nacos, fastmcp, config

# Nacos MCP 使用指南

一个基于 FastMCP 的 Model Context Protocol (MCP) 工具，用于读取 Nacos 配置、查看历史版本、对比变更以及检查服务注册状态，兼容 Nacos 2.4.x。

---

## 📋 目录

1. [功能特点](#功能特点)
2. [快速开始](#快速开始)
3. [在 Cursor 中集成](#在-cursor-中集成)
4. [工具功能](#工具功能)
5. [使用示例](#使用示例)
6. [常见问题](#常见问题)

---

## 功能特点

### 核心能力

- 📄 **配置读取**：按 Data ID 获取单个配置或批量读取多个配置
- 🧭 **历史追溯**：列出配置历史、获取详情、自动对比最近两版
- ✅ **服务状态检查**：查看服务实例、健康状态、注册情况
- 🧩 **上下文汇总**：一次性聚合配置、历史与服务状态信息
- 🔐 **鉴权支持**：支持用户名密码登录，自动管理 token
- 🧰 **兼容 Nacos 2.4.x**：对接口版本差异做兜底处理

### 配置灵活性

工具支持多种配置方式，按优先级自动选择：

1. **方法参数**（调用时直接传入）
2. **环境变量**（Cursor MCP 配置或系统环境变量）
3. **默认值**（工具内置）

---

## 快速开始

### 环境准备

#### Python 版本要求

- **Python 3.8 或更高版本**（推荐 Python 3.9+）
- 支持 Windows、Linux、Mac 操作系统

#### 检查 Python 环境

```bash
# 检查 Python 版本
python --version
# 或
py --version
```

#### 检查 pip 是否可用

```bash
# 检查 pip 版本
pip --version
# 或
py -m pip --version
```

### 安装

#### 从 PyPI 安装（默认）

```bash
pip install mcp-nacos-helper
```

#### 使用国内镜像源（可选）

```bash
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple mcp-nacos-helper
```

---

## 在 Cursor 中集成

示例配置见：`configs/cursor-mcp-config-example.json`

推荐在 `env` 中补充：

- `PYTHONUTF8=1`
- `PYTHONIOENCODING=utf-8`

**PyPI 安装模式示例**：

```json
{
  "mcpServers": {
    "nacos-helper-pypi": {
      "command": "py",
      "args": [
        "-m",
        "mcp_services.nacos.tool"
      ],
      "cwd": "${workspaceFolder}",
      "env": {
        "PYTHONUTF8": "1",
        "PYTHONIOENCODING": "utf-8",
        "NACOS_SERVER_ADDR": "http://127.0.0.1:8848",
        "NACOS_NAMESPACE": "sae-dev",
        "NACOS_GROUP": "DEFAULT_GROUP",
        "NACOS_USERNAME": "nacos",
        "NACOS_PASSWORD": "nacos",
        "NACOS_TIMEOUT": "5",
        "NACOS_DATA_IDS": "application.yml,bootstrap.yml",
        "NACOS_REGISTRY_NAMESPACE": "sae-registry"
      }
    }
  }
}
```

**说明**：
- `NACOS_NAMESPACE`：配置读取命名空间
- `NACOS_REGISTRY_NAMESPACE`：服务注册查询命名空间（可选）
- `PYTHONUTF8`/`PYTHONIOENCODING`：避免中文乱码

---

## 工具功能

工具提供以下能力（文字说明）：

- **配置读取**：读取单个或多个配置
- **历史追溯**：列出历史、获取详情、对比最近两版
- **服务状态检查**：查看实例与健康状态
- **上下文汇总**：聚合配置、历史、服务状态

---

## 使用示例

示例均为“自然语言调用”，适合在 Cursor 中直接提问：

```
读取 cdc-major-disease-service.yml 的配置
对比 cdc-major-disease-service.yml 最近两版历史
检查 CDC-MAJOR-DISEASE-SERVICE 是否已注册
```

---

## 常见问题

### 1) 历史接口提示需要 nid

工具已自动处理，直接使用“获取最新历史”或“对比最近两版”的能力即可。

### 2) 历史返回 0，但控制台有数据

多为 namespace 参数或接口版本差异导致，请检查：

- `NACOS_NAMESPACE`
- `NACOS_REGISTRY_NAMESPACE`

### 3) 中文输出乱码

在环境变量中添加：

- `PYTHONUTF8=1`
- `PYTHONIOENCODING=utf-8`
arthas-mcp-server 1.0.1
MCP Server for Arthas remote diagnostics - Simplified version without config file
License: MIT
Requires Python: >=3.8
Keywords: arthas, mcp, diagnostics, java, debugging

# Arthas MCP Server

通用的 Arthas 代理 MCP Server，支持多实例管理。

## 功能特性

- 支持多个 Arthas 实例管理
- 统一的命令执行接口
- 安全的 Token 认证
- 环境变量配置支持
- 完整的审计日志

## 安装

```bash
pip install arthas-mcp-server
```

## 配置

在用户目录下创建配置文件 `~/.arthas-mcp/config.json`：

```json
{
  "instances": [
    {
      "name": "shop-frontend-daily",
      "url": "https://your-domain.com/internal/arthas",
      "token": "${ARTHAS_TOKEN_DAILY}",
      "description": "Shop Frontend Daily Environment"
    }
  ]
}
```

支持环境变量替换，格式为 `${ENV_VAR_NAME}`。

## 使用方法

### 1. 启动 MCP Server

```bash
arthas-mcp
```

### 2. 在 Claude Desktop 中配置

编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`：

```json
{
  "mcpServers": {
    "arthas": {
      "command": "arthas-mcp"
    }
  }
}
```

### 3. 可用工具

- `arthas_list_instances`: 列出所有配置的 Arthas 实例
- `arthas_execute`: 在指定实例上执行 Arthas 命令

## 示例

```
列出所有实例：
arthas_list_instances

执行命令：
arthas_execute(
  instance_name="shop-frontend-daily",
  command="dashboard",
  operator="claude"
)
```

## 支持的 Arthas 命令

- dashboard: 系统实时数据面板
- thread: 线程信息
- jvm: JVM 信息
- memory: 内存信息
- watch: 方法执行观测
- trace: 方法调用路径追踪
- stack: 方法调用堆栈
- tt: 时间隧道记录
- monitor: 方法执行监控
- jad: 反编译类
- sc: 查找类
- sm: 查找方法

## 许可证

MIT License