代理
具有MCP（模型上下文协议）服务器支持的AI代理的CLI。
建在上面 AgentKit 的 图书馆。
安装
需求
- 晶体>=1.19.0
- OpenAI API密钥（或兼容提供程序）
从源代码构建
git clone https://github.com/alexkutsan/agentish.git
cd agentish
shards install
shards build --release二进制将位于 ./bin/agentish.
______________________________________________________________________
快速开始
1.创建配置
mkdir -p ~/.config/agentish
cat > ~/.config/agentish/config.json << 'EOF'
{
"openaiApiKey": "sk-your-api-key-here",
"openaiModel": "gpt-4o"
}
EOF2.运行代理
./bin/agentish -p "Hello! How are you?"______________________________________________________________________
用法
# Direct prompt
./bin/agentish -p "Your question"
# Prompt from file
./bin/agentish prompt.txt
# Output to file
./bin/agentish -p "Generate a list" -o result.txt
# Interactive mode
./bin/agentish -i
# Specify config
./bin/agentish -p "Question" -c /path/to/config.json选项
| 选项 | 描述 |
|---|---|
-p, --prompt | 提示文本 |
-o, --output | 输出文件（默认：stdout） |
-c, --config | 配置文件路径 |
-i, --interactive | 交互模式（REPL） |
-h, --help | 显示帮助 |
-v, --version | 显示版本 |
______________________________________________________________________
配置
代理在以下位置查找配置：
~/.config/crystal_agent/config.json~/.crystal_agent.json
最小配置
{
"openaiApiKey": "sk-..."
}完整配置
{
"openaiApiKey": "sk-...",
"openaiApiHost": "https://api.openai.com",
"openaiModel": "gpt-4o",
"maxIterations": 10,
"timeoutSeconds": 120,
"mcpServers": {
"my-server": {
"type": "http",
"url": "http://localhost:8000/mcp"
}
}
}| 参数 | 说明 | 默认值 |
|---|---|---|
openaiApiKey | API密钥（必需） | - |
openaiApiHost | API URL | https://api.openai.com |
openaiModel | 型号 | gpt-4o |
maxIterations | 最大迭代次数 | 10 |
timeoutSeconds | 超时（秒） | 120 |
mcpServers | MCP服务器 | {} |
日志记录 通过ENV配置： CRYSTAL_AGENT_LOG_LEVEL （debug/info/awarn/error，默认值 warn)以及 CRYSTAL_AGENT_LOG_FILE.
______________________________________________________________________
MCP服务器
代理可以连接到MCP服务器以使用外部工具。
没有HTTP配置 "type": "http" 被视为无效。环境变量可以用作 ${VAR} 或 ${VAR:-default}.
{
"openaiApiKey": "sk-...",
"mcpServers": {
"filesystem": {
"type": "http",
"url": "http://localhost:8000/mcp"
},
"database": {
"type": "http",
"url": "http://localhost:8001/mcp",
"headers": {
"Authorization": "Bearer token"
}
}
}
}Stdio MCP服务器（本地进程）
{
"openaiApiKey": "sk-...",
"mcpServers": {
"local-tools": {
"command": "python3",
"args": ["-u", "/path/to/mcp_server.py"]
}
}
}启动时，代理会自动连接到服务器并注册可用工具。
______________________________________________________________________
文档
- 用户指南.md --详细用户指南
- AgentKit 的 --图书馆文献
______________________________________________________________________
许可证
麻省理工学院