TheVoices/README.md

56 lines
1.4 KiB
Markdown

# TheVoices
A FastMCP server providing role-based AI assistant tools for specialized AI personas and LLM model discovery.
## Features
- **Model Discovery**: Auto-detect available LLM models based on API keys
- **Role-based AI**: Create specialized AI assistants with defined expertise and personas
- **Multiple Providers**: Support for OpenAI, Anthropic, Azure, and other LLM providers
## Usage
For example in Zed:
```json
"context_servers": {
"TheVoices": {
"source": "custom",
"command": {
"path": "uvx thevoices",
"args": [],
"env": {
"LITELLM_MODEL": "openai/gpt-4.1",
"ANTHROPIC_API_KEY": "YOUR_API_KEY",
"OPENAI_API_KEY": "YOUR_API_KEY"
}
}
}
}
```
### Available Tools
#### `list_available_models()`
Returns available LLM models based on your API keys.
#### `ask_the_voice(role_title, role_description, context, task, model?, temperature?)`
Create specialized AI assistants with defined roles and expertise.
**Example:**
```python
ask_the_voice(
role_title="The Security Architect",
role_description="Senior cybersecurity expert specializing in threat analysis",
context="We detected unusual network traffic patterns...",
task="Analyze this security incident and provide remediation steps"
)
```
## Requirements
- Python 3.13+
- FastMCP 2.9.2+
- LiteLLM 1.73.6+
- Valid API keys for at least one LLM provider