iflow-mcp_halfaipg-glados-mcp 0.1.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- iflow_mcp_halfaipg_glados_mcp-0.1.0/.gitignore +40 -0
- iflow_mcp_halfaipg_glados_mcp-0.1.0/PKG-INFO +160 -0
- iflow_mcp_halfaipg_glados_mcp-0.1.0/README.md +133 -0
- iflow_mcp_halfaipg_glados_mcp-0.1.0/models/glados.json +497 -0
- iflow_mcp_halfaipg_glados_mcp-0.1.0/models/idx_to_token.pkl +0 -0
- iflow_mcp_halfaipg_glados_mcp-0.1.0/models/lang_phoneme_dict.pkl +0 -0
- iflow_mcp_halfaipg_glados_mcp-0.1.0/models/lang_phoneme_dict_old.pkl +0 -0
- iflow_mcp_halfaipg_glados_mcp-0.1.0/models/phoneme_to_id.pkl +0 -0
- iflow_mcp_halfaipg_glados_mcp-0.1.0/models/token_to_idx.pkl +0 -0
- iflow_mcp_halfaipg_glados_mcp-0.1.0/pyproject.toml +56 -0
- iflow_mcp_halfaipg_glados_mcp-0.1.0/sounds/looping_radio_mix.wav +0 -0
- iflow_mcp_halfaipg_glados_mcp-0.1.0/sounds/portal_elevator_chime.wav +0 -0
- iflow_mcp_halfaipg_glados_mcp-0.1.0/tts/__init__.py +3 -0
- iflow_mcp_halfaipg_glados_mcp-0.1.0/tts/__main__.py +6 -0
- iflow_mcp_halfaipg_glados_mcp-0.1.0/tts/glados_manager.py +245 -0
- iflow_mcp_halfaipg_glados_mcp-0.1.0/tts/server.py +126 -0
- iflow_mcp_halfaipg_glados_mcp-0.1.0/tts/tts/__init__.py +24 -0
- iflow_mcp_halfaipg_glados_mcp-0.1.0/tts/tts/phonemizer.py +590 -0
- iflow_mcp_halfaipg_glados_mcp-0.1.0/tts/tts/tts_glados.py +323 -0
- iflow_mcp_halfaipg_glados_mcp-0.1.0/tts/tts/tts_kokoro.py +161 -0
- iflow_mcp_halfaipg_glados_mcp-0.1.0/tts/utils/__init__.py +6 -0
- iflow_mcp_halfaipg_glados_mcp-0.1.0/tts/utils/resources.py +17 -0
- iflow_mcp_halfaipg_glados_mcp-0.1.0/tts/utils/spoken_text_converter.py +800 -0
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# Large model files - download with download_models.py
|
|
2
|
+
glados-mcp/models/*.onnx
|
|
3
|
+
glados-mcp/models/*.bin
|
|
4
|
+
|
|
5
|
+
# Virtual environments
|
|
6
|
+
glados-mcp/venv/
|
|
7
|
+
**/venv/
|
|
8
|
+
**/.venv/
|
|
9
|
+
|
|
10
|
+
# Python cache
|
|
11
|
+
__pycache__/
|
|
12
|
+
*.pyc
|
|
13
|
+
*.pyo
|
|
14
|
+
*.pyd
|
|
15
|
+
.Python
|
|
16
|
+
build/
|
|
17
|
+
develop-eggs/
|
|
18
|
+
dist/
|
|
19
|
+
downloads/
|
|
20
|
+
eggs/
|
|
21
|
+
.eggs/
|
|
22
|
+
lib/
|
|
23
|
+
lib64/
|
|
24
|
+
parts/
|
|
25
|
+
sdist/
|
|
26
|
+
var/
|
|
27
|
+
wheels/
|
|
28
|
+
*.egg-info/
|
|
29
|
+
.installed.cfg
|
|
30
|
+
*.egg
|
|
31
|
+
|
|
32
|
+
# IDE
|
|
33
|
+
.vscode/
|
|
34
|
+
.idea/
|
|
35
|
+
*.swp
|
|
36
|
+
*.swo
|
|
37
|
+
|
|
38
|
+
# OS
|
|
39
|
+
.DS_Store
|
|
40
|
+
Thumbs.db glados-mcp/venv/
|
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: iflow-mcp_halfaipg-glados-mcp
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: GLaDOS MCP Server - Snarky AI voice commentary for your development workflow
|
|
5
|
+
Author: GLaDOS MCP Team
|
|
6
|
+
License: MIT
|
|
7
|
+
Keywords: ai-voice,commentary,development,glados,mcp,text-to-speech,tts
|
|
8
|
+
Classifier: Development Status :: 4 - Beta
|
|
9
|
+
Classifier: Intended Audience :: Developers
|
|
10
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
11
|
+
Classifier: Operating System :: MacOS
|
|
12
|
+
Classifier: Operating System :: POSIX :: Linux
|
|
13
|
+
Classifier: Programming Language :: Python :: 3
|
|
14
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
15
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
17
|
+
Requires-Python: >=3.10
|
|
18
|
+
Requires-Dist: anyio>=4.5
|
|
19
|
+
Requires-Dist: click>=8.1.0
|
|
20
|
+
Requires-Dist: mcp
|
|
21
|
+
Requires-Dist: numpy
|
|
22
|
+
Requires-Dist: onnxruntime>=1.16.0
|
|
23
|
+
Requires-Dist: pydantic>=2.10.6
|
|
24
|
+
Requires-Dist: sounddevice
|
|
25
|
+
Requires-Dist: soundfile>=0.13.0
|
|
26
|
+
Description-Content-Type: text/markdown
|
|
27
|
+
|
|
28
|
+
# GLaDOS MCP Server
|
|
29
|
+
|
|
30
|
+
A Model Context Protocol server that provides GLaDOS-style voice commentary for AI development workflows, along with professional Kokoro TTS voices.
|
|
31
|
+
|
|
32
|
+
## Overview
|
|
33
|
+
|
|
34
|
+
This project combines:
|
|
35
|
+
|
|
36
|
+
- **GLaDOS Voice**: Authentic Portal-style audio synthesis with characteristic commentary
|
|
37
|
+
- **Professional Alternatives**: 26 Kokoro voices for serious development work
|
|
38
|
+
- **MCP Integration**: Seamless integration with existing Model Context Protocol tools
|
|
39
|
+
|
|
40
|
+
## Demo Videos (Turn on sound)
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
https://github.com/user-attachments/assets/f5623dd5-ac9b-4adc-8641-104d634504c7
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
https://github.com/user-attachments/assets/542fb5c6-03ab-4f4d-9e73-0d7f29a71c4e
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
## Installation
|
|
52
|
+
|
|
53
|
+
### 1. Download Models (Required)
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
python download_models.py
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
### 2. Install System Dependencies
|
|
60
|
+
|
|
61
|
+
**Linux (Ubuntu/Debian):**
|
|
62
|
+
```bash
|
|
63
|
+
sudo apt update
|
|
64
|
+
sudo apt install portaudio19-dev python3-pyaudio
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
**Linux (Fedora/RHEL):**
|
|
68
|
+
```bash
|
|
69
|
+
sudo dnf install portaudio-devel python3-pyaudio
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
**macOS:**
|
|
73
|
+
```bash
|
|
74
|
+
brew install portaudio
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
### 3. Install the Server
|
|
78
|
+
```bash
|
|
79
|
+
cd glados-mcp
|
|
80
|
+
python -m venv venv
|
|
81
|
+
source venv/bin/activate # Windows users: venv\Scripts\activate
|
|
82
|
+
pip install -e .
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
## Configuration
|
|
86
|
+
|
|
87
|
+
Add this to your MCP client configuration:
|
|
88
|
+
|
|
89
|
+
```json
|
|
90
|
+
{
|
|
91
|
+
"mcpServers": {
|
|
92
|
+
"glados-mcp": {
|
|
93
|
+
"command": "./glados-mcp/venv/bin/python",
|
|
94
|
+
"args": ["-m", "tts.server"],
|
|
95
|
+
"cwd": "./glados-mcp",
|
|
96
|
+
"env": {
|
|
97
|
+
"PYTHONPATH": "./glados-mcp",
|
|
98
|
+
"MCP_DEBUG": "1",
|
|
99
|
+
"MCP_LOG_LEVEL": "DEBUG"
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
**Note:** Make sure the paths match your actual installation directory. If you installed in a different location, adjust the `command` and `cwd` paths accordingly.
|
|
107
|
+
|
|
108
|
+
## Usage
|
|
109
|
+
|
|
110
|
+
The interface is straightforward:
|
|
111
|
+
|
|
112
|
+
**Default GLaDOS Voice**:
|
|
113
|
+
```python
|
|
114
|
+
speak("Your code is... adequate. I suppose.")
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
**Professional Kokoro Voices**:
|
|
118
|
+
```python
|
|
119
|
+
speak("Analysis complete.", voice="af_alloy")
|
|
120
|
+
speak("Task finished.", voice="bm_daniel")
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
**Available Voices**:
|
|
124
|
+
```python
|
|
125
|
+
list_voices() # Returns all 26 Kokoro voices plus GLaDOS
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
## Voice Options
|
|
129
|
+
|
|
130
|
+
- **GLaDOS** (default): Characteristic Portal-style commentary
|
|
131
|
+
- **Kokoro Female US**: af_alloy, af_aoede, af_bella, af_jessica, af_kore, af_nicole, af_nova, af_river, af_sarah, af_sky
|
|
132
|
+
- **Kokoro Female British**: bf_alice, bf_emma, bf_isabella, bf_lily
|
|
133
|
+
- **Kokoro Male US**: am_adam, am_echo, am_eric, am_fenrir, am_liam, am_michael, am_onyx, am_puck
|
|
134
|
+
- **Kokoro Male British**: bm_daniel, bm_fable, bm_george, bm_lewis
|
|
135
|
+
|
|
136
|
+
## Project Structure
|
|
137
|
+
|
|
138
|
+
```
|
|
139
|
+
├── download_models.py # Downloads TTS models (run this first!)
|
|
140
|
+
├── mcp.json # MCP client configuration
|
|
141
|
+
├── glados-mcp/ # Main server code
|
|
142
|
+
│ ├── tts/ # TTS system
|
|
143
|
+
│ ├── models/ # Voice models (downloaded by script)
|
|
144
|
+
│ └── README.md # Detailed instructions
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
## Requirements
|
|
148
|
+
|
|
149
|
+
- Python 3.10+
|
|
150
|
+
- Audio output
|
|
151
|
+
- Internet connection for model download
|
|
152
|
+
- **Linux**: PortAudio system library (`portaudio19-dev`)
|
|
153
|
+
|
|
154
|
+
## License
|
|
155
|
+
|
|
156
|
+
Apache 2.0
|
|
157
|
+
|
|
158
|
+
---
|
|
159
|
+
|
|
160
|
+
*"The cake is a lie, but the voice commentary is real."*
|
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
# GLaDOS MCP Server
|
|
2
|
+
|
|
3
|
+
A Model Context Protocol server that provides GLaDOS-style voice commentary for AI development workflows, along with professional Kokoro TTS voices.
|
|
4
|
+
|
|
5
|
+
## Overview
|
|
6
|
+
|
|
7
|
+
This project combines:
|
|
8
|
+
|
|
9
|
+
- **GLaDOS Voice**: Authentic Portal-style audio synthesis with characteristic commentary
|
|
10
|
+
- **Professional Alternatives**: 26 Kokoro voices for serious development work
|
|
11
|
+
- **MCP Integration**: Seamless integration with existing Model Context Protocol tools
|
|
12
|
+
|
|
13
|
+
## Demo Videos (Turn on sound)
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
https://github.com/user-attachments/assets/f5623dd5-ac9b-4adc-8641-104d634504c7
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
https://github.com/user-attachments/assets/542fb5c6-03ab-4f4d-9e73-0d7f29a71c4e
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
## Installation
|
|
25
|
+
|
|
26
|
+
### 1. Download Models (Required)
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
python download_models.py
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
### 2. Install System Dependencies
|
|
33
|
+
|
|
34
|
+
**Linux (Ubuntu/Debian):**
|
|
35
|
+
```bash
|
|
36
|
+
sudo apt update
|
|
37
|
+
sudo apt install portaudio19-dev python3-pyaudio
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
**Linux (Fedora/RHEL):**
|
|
41
|
+
```bash
|
|
42
|
+
sudo dnf install portaudio-devel python3-pyaudio
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
**macOS:**
|
|
46
|
+
```bash
|
|
47
|
+
brew install portaudio
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
### 3. Install the Server
|
|
51
|
+
```bash
|
|
52
|
+
cd glados-mcp
|
|
53
|
+
python -m venv venv
|
|
54
|
+
source venv/bin/activate # Windows users: venv\Scripts\activate
|
|
55
|
+
pip install -e .
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
## Configuration
|
|
59
|
+
|
|
60
|
+
Add this to your MCP client configuration:
|
|
61
|
+
|
|
62
|
+
```json
|
|
63
|
+
{
|
|
64
|
+
"mcpServers": {
|
|
65
|
+
"glados-mcp": {
|
|
66
|
+
"command": "./glados-mcp/venv/bin/python",
|
|
67
|
+
"args": ["-m", "tts.server"],
|
|
68
|
+
"cwd": "./glados-mcp",
|
|
69
|
+
"env": {
|
|
70
|
+
"PYTHONPATH": "./glados-mcp",
|
|
71
|
+
"MCP_DEBUG": "1",
|
|
72
|
+
"MCP_LOG_LEVEL": "DEBUG"
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
**Note:** Make sure the paths match your actual installation directory. If you installed in a different location, adjust the `command` and `cwd` paths accordingly.
|
|
80
|
+
|
|
81
|
+
## Usage
|
|
82
|
+
|
|
83
|
+
The interface is straightforward:
|
|
84
|
+
|
|
85
|
+
**Default GLaDOS Voice**:
|
|
86
|
+
```python
|
|
87
|
+
speak("Your code is... adequate. I suppose.")
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
**Professional Kokoro Voices**:
|
|
91
|
+
```python
|
|
92
|
+
speak("Analysis complete.", voice="af_alloy")
|
|
93
|
+
speak("Task finished.", voice="bm_daniel")
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
**Available Voices**:
|
|
97
|
+
```python
|
|
98
|
+
list_voices() # Returns all 26 Kokoro voices plus GLaDOS
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
## Voice Options
|
|
102
|
+
|
|
103
|
+
- **GLaDOS** (default): Characteristic Portal-style commentary
|
|
104
|
+
- **Kokoro Female US**: af_alloy, af_aoede, af_bella, af_jessica, af_kore, af_nicole, af_nova, af_river, af_sarah, af_sky
|
|
105
|
+
- **Kokoro Female British**: bf_alice, bf_emma, bf_isabella, bf_lily
|
|
106
|
+
- **Kokoro Male US**: am_adam, am_echo, am_eric, am_fenrir, am_liam, am_michael, am_onyx, am_puck
|
|
107
|
+
- **Kokoro Male British**: bm_daniel, bm_fable, bm_george, bm_lewis
|
|
108
|
+
|
|
109
|
+
## Project Structure
|
|
110
|
+
|
|
111
|
+
```
|
|
112
|
+
├── download_models.py # Downloads TTS models (run this first!)
|
|
113
|
+
├── mcp.json # MCP client configuration
|
|
114
|
+
├── glados-mcp/ # Main server code
|
|
115
|
+
│ ├── tts/ # TTS system
|
|
116
|
+
│ ├── models/ # Voice models (downloaded by script)
|
|
117
|
+
│ └── README.md # Detailed instructions
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
## Requirements
|
|
121
|
+
|
|
122
|
+
- Python 3.10+
|
|
123
|
+
- Audio output
|
|
124
|
+
- Internet connection for model download
|
|
125
|
+
- **Linux**: PortAudio system library (`portaudio19-dev`)
|
|
126
|
+
|
|
127
|
+
## License
|
|
128
|
+
|
|
129
|
+
Apache 2.0
|
|
130
|
+
|
|
131
|
+
---
|
|
132
|
+
|
|
133
|
+
*"The cake is a lie, but the voice commentary is real."*
|