semvec/pypi-packages huggingface dataset:
mcp-smartsearch 0.1.5
A smart search MCP server.
Requires Python: >=3.10

# Smart Search MCP Server

一个集成远程智能搜索 API 的 MCP 服务器，实现关键词网页搜索功能。

## 特性

-   **网页搜索**：支持关键词检索、分页、语言和安全等级选项。
-   **结构化返回**：所有搜索结果以 JSON 格式返回。
-   **平台兼容**：为 ModelScope MCP 平台优化，支持从源码直接部署。

## 工具

### `smart_search`

-   **功能**: 执行网页搜索，支持分页与安全选项。
-   **输入参数**:
    -   `query` (string): 搜索关键词
    -   `count` (number, optional): 返回结果数量 (默认 10)
    -   `offset` (number, optional): 分页偏移 (默认 0)
    -   `setLang` (string, optional): 搜索语言 (默认 'en')
    -   `safeSearch` (string, optional): 安全搜索等级 (默认 'Strict')

## 配置与部署

### 1. 获取 API 密钥

-   注册一个支持智能搜索的 API 服务。
-   获取并复制你的 API 密钥（格式通常为 `endpoint-apikey`）。

### 2. ModelScope 服务配置

在 ModelScope 创建 MCP 服务时，请使用以下配置。这种方式会从你的 GitHub 仓库拉取代码，并直接运行。

```json
{
  "mcpServers": {
    "mcp-smartsearch": {
      "command": "uv",
      "args": [
        "run",
        "src/mcp-smartsearch/server.py"
      ],
      "env": {
        "SERVER_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}
```
mdreport 0.3.0
A simple CLI to convert markdown files to HTML using GitHub API using the GitHub Markdown style.
Requires Python: >=3.6
Keywords: markdown, github, cli, html, converter

# ghmd

ghmd (GitHub Markdown) is an extremely light-weight and simple command line tool to convert GitHub Flavored Markdown (or [plain Markdown](#no-gfm)) to HTML.

It does so by using the [GitHub Markdown API](https://docs.github.com/en/free-pro-team@latest/rest/reference/markdown) in combination with [GitHub Markdown CSS](https://github.com/sindresorhus/github-markdown-css).

## Installation

```bash
pip install ghmd
```

## Usage

Simply run `ghmd` with the path to the markdown file(s) you want to convert. An HTML file will be created in the same directory as the markdown file with the same filename.

```bash
ghmd README.md
# or
ghmd README.md CONTRIBUTING.md
```

> [!NOTE]
> If you don't have the `ghmd` command available after installing, you may need to add the Python scripts directory to your PATH environment variable.
>
> Otherwise you, can use `python -m ghmd` instead of `ghmd`.

## Options

### GitHub API Token

By default, ghmd uses unauthenticated requests to the GitHub API, which has a rate limit of 60 requests per hour. To increase this limit to 5000 requests per hour, you can set the `GITHUB_TOKEN` environment variable with a GitHub personal access token:

```bash
export GITHUB_TOKEN=your_github_token_here
ghmd README.md
```

To create a personal access token, visit your [GitHub Settings > Developer Settings > Personal access tokens](https://github.com/settings/tokens) and create a new token (no specific scopes are required).

### `--embed-css`

By default, ghmd will add the remote CSS as a `<link>` tag in the HTML file. If you want to embed the CSS directly into the HTML file so that, for example, you can send the HTML file to someone else and they can view it without an internet connection, you can use the `--embed-css` option.

```bash
ghmd README.md --embed-css
```

### `--light` and `--dark`

The default CSS styles adapt to the system's dark mode setting of the reader. If you want to force the CSS to be light or dark, you can use the `--light` or `--dark` options.

```bash
ghmd README.md --light
# or
ghmd README.md --dark
```

Both `--light` and `--dark` can be used in combination with `--embed-css`.

> [!NOTE]
> Using the `--embed-css` option will result in a ~25 KB larger HTML file size (~18 KB when using `--light` or `--dark`).

### `--no-gfm`

The tool offers two modes: GitHub Flavored Markdown (gfm, default) and plain Markdown. To use the later, the `--no-gfm` option can be used:

```bash
ghmd README.md --no-gfm
```