semvec/pypi-packages huggingface dataset:
hkopenai.document-as-code-mcp-server 0.2.1
This is a MCP server to provide mermaid js validation tools and prompt for MCP client
Requires Python: >=3.10

# Document as Code MCP Server

[![GitHub Repository](https://img.shields.io/badge/GitHub-Repository-blue.svg)](https://github.com/hkopenai/hk-prompt-mcp-server)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

This is a MCP server to provide mermaid js validation tools and prompt for MCP client

## Why Use This MCP Server?

This MCP server is essential for MCP clients working with Mermaid.js diagrams. Large Language Models (LLMs) might be trained with older data and outdated Mermaid.js syntax, and they may not have enough content trained to effectively fix syntax errors. This server addresses these critical limitations by providing specialized tools to assist in authoring, validating, and automatically fixing Mermaid.js syntax, ensuring diagrams are correctly formatted and functional.

## Features

- No Brackets Description: A prompt to instruct bots to avoid using brackets in descriptions.
- Mermaid.js Support: A tool to assist in authoring, validating, and fixing syntax for Mermaid.js diagrams.

## Setup

1. Clone this repository
2. Install Python dependencies:
   ```bash
   pip install -r requirements.txt
   ```
3. Run the server:
   ```bash
   python -m hkopenai.document_as_code_mcp_server
   ```

### Running Options

- Default stdio mode: `python -m hkopenai.document_as_code_mcp_server`
- SSE mode (port 8000): `python -m hkopenai.document_as_code_mcp_server --sse`
- Serve prompt as tool: `python -m hkopenai.document_as_code_mcp_server --tool`

## Cline Integration

Cline does not support prompt from mcp server at this moment. The prompt is provided as tool:

To connect this MCP server to Cline using stdio:

1. Add this configuration to your Cline MCP settings (cline_mcp_settings.json):
```json
{
  "hk-prompt-server": {
    "disabled": false,
    "timeout": 3,
    "type": "stdio",
    "command": "python",
    "args": [
      "-m",
      "hkopenai.document_as_code_mcp_server",
      "--tool"
    ]
  }
}
```

## Testing

Tests are available in `tests`. Run with:
```bash
pytest
```
python-appimage 1.4.5
Appimage releases of Python
Requires Python: >=3.9

# AppImage distributions of Python

_Ready to use AppImages of Python are available as GitHub [releases][RELEASES]._


## Quickstart

We provide relocatable Python runtimes in the form of [AppImages][APPIMAGE] for
Linux systems. These runtimes are extracted from [Manylinux][MANYLINUX] Docker
images and are available as GitHub [releases][RELEASES]. Our Python AppImages
are updated weekly, on every Sunday.

Instructions for _installing_ and running _Python AppImages_ can be found on
[Read the Docs][READTHEDOCS].

The online documentation also describes the [`python-appimage`][PYPI] utility
for application developers. This utility can facilitate the development of
Python applications, provided you have an existing Python AppImage and a recipe
folder. [Examples][APPLICATIONS] of recipes are available on GitHub.


## Projects using [`python-appimage`][GITHUB]

* [grand/python](https://github.com/grand-mother/python) - Contained, portable
  and modern python for [GRAND][GRAND] running from an AppImage
* [rever](https://github.com/regro/rever) - Cross-platform software release tool.
* [ssh-mitm](https://github.com/ssh-mitm/ssh-mitm) - ssh mitm server for security audits
* [xonsh](https://github.com/xonsh/xonsh) - Python-powered, cross-platform, Unix-gazing
  shell language and command prompt
* [xxh](https://github.com/xxh/xxh) - Bring your favorite shell wherever you go
  through the ssh


## License

The [`python-appimage`][PYPI] package (**A**) is under the GNU GPLv3 license,
except for files located under `python_appimage/data` which are MIT licensed.
Thus, the produced Manylinux Python AppImages (**B**) are not GPL'd. They
contain a CPython distribution that is (mostly) under the [PSF
license][PSF_LICENSE]. Other parts of **B** (e.g. `AppRun`) are under the MIT
license.


[APPLICATIONS]: https://github.com/niess/python-appimage/tree/master/applications
[APPIMAGE]: https://appimage.org/
[GITHUB]: https://github.com/niess/python-appimage
[GRAND]: http://grand.cnrs.fr
[MANYLINUX]: https://github.com/pypa/manylinux
[PSF_LICENSE]: https://docs.python.org/3/license.html#psf-license
[PYPI]: https://pypi.org/project/python-appimage/
[READTHEDOCS]: https://python-appimage.readthedocs.io/en/latest/
[RELEASES]: https://github.com/niess/python-appimage/releases
incogniton-py 0.1.1
Python client for Incogniton API
Requires Python: <4.0,>=3.9

# Incogniton Python Client (Still In Development)

A Python client for interacting with the Incogniton browser automation platform.

## Installation

```bash
# Using Poetry (recommended)
poetry install

# Or using pip
pip install -e .
```

## Development

To run tests:

```bash
# Using Poetry
poetry run pytest

# Or using pytest directly
pytest tests/
```

## Features

-  Profile and launch management
-  Cookie management
-  Browser automation with Selenium and Puppeteer
-  Support for headless mode
mt-speech-mcp-server 0.0.2
美团语音 MCP服务器 - 提供文本转语音和语音识别等语音功能
Requires Python: >=3.10

# 美团语音 MCP服务器

本项目是基于 MCP 协议的美团语音服务 Server，适用于中文开发者，支持通过 MCP 控制器（如 cursor）调用美团 TTS 能力，实现文本转语音等功能。

---

## 目录
- [项目简介](#项目简介)
- [功能特性](#功能特性)
- [环境依赖与配置](#环境依赖与配置)
- [快速上手](#快速上手)
- [常见问题](#常见问题)
- [参考文档](#参考文档)

---

## 项目简介

本项目实现了一个 MCP 标准服务端，封装美团语音能力，适合对接 windsurf、Claude Desktop 等 MCP 控制器。支持标准的文本转语音接口，便于集成到各类自动化、AI 工具链。

---

## 功能特性
- 文本转语音（TTS）：支持指定文本、音色、语速、音量、采样率、音频格式等参数
- 语音转文本（ASR）: 支持指定音频文件格式、采样率、声道数、采样位数等参数
- 标准 MCP 协议，兼容 windsurf 等主流控制器
- 环境变量灵活配置，适合多环境部署

---

## 使用

### 依赖环境
- Python 3.10 及以上
- 已安装依赖包（见 requirements.txt）

### 获取APPKEY和SECRETKEY

| 变量名                     | 说明                   | 是否必须 |
|----------------------------|------------------------|----------|
| MEITUAN_TTS_APP_KEY        | 美团TTS服务AppKey      | 是       |
| MEITUAN_TTS_SECRET_KEY     | 美团TTS服务SecretKey   | 是       |
| MEITUAN_ASR_APP_KEY        | 美团ASR服务AppKey      | 是       |
| MEITUAN_ASR_SECRET_KEY     | 美团ASR服务SecretKey   | 是       |

### 安装uv
执行`` curl -LsSf https://astral.sh/uv/install.sh | sh ``或按照官网文档安装
### 配置MCP
已windsurf为例，在mcp_config.json中配置如下内容：
```json
{
  "mcpServers": {
    "meituan-speech-mcp-server": {
      "command": "uvx",
      "args": ["mt-speech-mcp-server", "-y"],
      "env": {
        "MEITUAN_TTS_APP_KEY": "你的TTS_AppKey",
        "MEITUAN_TTS_SECRET_KEY": "你的TTS_SecretKey",
        "MEITUAN_ASR_APP_KEY": "你的ASR_AppKey",
        "MEITUAN_ASR_SECRET_KEY": "你的ASR_SecretKey"
      }
    }
  }
}
```
具体位置参考：

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
---
## 开发与调试

### 开发与调试

1. 同步依赖并更新锁文件：
   ```bash
   git clone <repository-url>
   cd speech-mcp-server
   ```

2. **安装依赖**：
   ```bash
   pip install -r requirements.txt
   ```

3. **配置环境变量**（见上文）

4. **配置 MCP 控制器**（windsurf 或 Claude Desktop，见上文）

5. **启动服务**：在 windsurf/Claude Desktop 中启动本服务，即可使用相关工具。

---

### 构建与发布

如需将本项目打包发布，可参考如下流程（需已安装 uv 工具）：

1. 同步依赖并更新锁文件：
   ```bash
   uv sync
   ```
2. 构建分发包：
   ```bash
   uv build
   ```
   构建结果将在 `dist/` 目录下生成。
3. 发布到 PyPI：
   ```bash
   uv publish
   ```
   发布前请配置好 PyPI 凭证，可用环境变量或命令行参数设置。

### 调试建议

由于 MCP Server 采用 stdio 通信，调试建议使用 [MCP Inspector](https://github.com/modelcontextprotocol/inspector) 工具。
可通过 npm 安装并运行：
```bash
npm install -g @modelcontextprotocol/inspector
mcp-inspector
```




- **认证失败**：检查 API 密钥是否正确配置
- **文件不存在**：确认音频文件路径是否正确
- **网络错误**：检查网络连接和 URL 有效性
- **格式不支持**：尝试使用其他音频格式或转换音频文件格式