内容
# 🌐 Sarvam AI MCP 服务器
**Sarvam AI MCP 服务器** 是一个轻量级、可扩展的 MCP（模型上下文协议）服务器，为基于 LLM 的客户端（Claude Desktop、Gemini CLI、Warp 等）提供强大的印度语言处理能力，包括翻译、音译、语言识别以及访问 SarvamAI-M 模型。
---
## 🚀 功能特点
- 🔍 **语言识别** — 自动检测输入文本的语言和脚本
- 🔤 **音译** — 在保留发音的情况下，将文本在不同的印度脚本之间转换
- 🌐 **翻译** — 在多种印度语言之间翻译文本
- 💬 **Sarvam 聊天** — 与 SarvamAI-M 模型进行交互式聊天（可选 wiki 基础）
---
## 🛠️ 安装与设置
### 先决条件
- Docker（推荐）
- 支持 MCP 的客户端（Claude Desktop、Gemini CLI、Warp 等）
- ngrok（远程 MCP）
### 1. 克隆仓库
```bash
git clone https://github.com/JDhruv14/Sarvam-MCP.git
cd Sarvam-MCP
```
### 2. 环境配置
创建或更新 `.env` 文件，添加您的 API 密钥：
```bash
SARVAM_API_KEY=您的_API_密钥_此处
```
### 可重复性与锁定文件
本项目在 `requirements.txt` 和 `requirements-dev.txt` 中使用固定版本以确保可重复性。
为了在不同环境中实现更严格的可重复性，请考虑：
- `pip freeze > requirements.lock`
- 使用 `uv` 或 `poetry` 进行依赖锁定
- 使用 Docker 镜像进行容器级一致性
### 3. Docker 设置（推荐）
**构建 Docker 镜像：**
```bash
docker build -t sarvam .
```
**运行容器：**
```bash
docker run -p 8080:8080 sarvam
```
### 4. 替代方案：本地开发设置
```bash
# 安装依赖
pip install -r requirements.txt
# 设置环境变量
export SARVAM_API_KEY=您的_API_密钥_此处
# 启动服务器
python sarvam_mcp.py
```
---
## ⚙️ MCP 客户端配置
### 桌面应用程序设置
通过编辑 `config.json` 文件并在 `mcpServers` 部分添加以下配置来配置您的 MCP 客户端：
#### 🏠 本地配置
```json
{
"mcpServers": {
"Sarvam_MCP": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"http://localhost:8080/mcp/",
"--header",
"Content-Type:application/json"
]
}
}
}
```
#### ☁️ 远程/云配置
**选项 1：云部署**
```json
{
"mcpServers": {
"Sarvam_MCP": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://您的云网址.com/mcp/",
"--header",
"Content-Type:application/json"
]
}
}
}
```
**选项 2：使用 ngrok 进行临时访问**
1. 安装并设置 ngrok：
```bash
# 访问 https://ngrok.com 获取安装说明
ngrok http 8080
```
2. 在您的配置中使用 ngrok URL：
```json
{
"mcpServers": {
"Sarvam_MCP": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://您的_ngrok_id.ngrok-free.app/mcp/",
"--header",
"Content-Type:application/json"
]
}
}
}
```
### 📁 配置文件位置
| 平台 | 配置路径 |
|----------|-------------------|
| **Claude Desktop (macOS)** | `~/Library/Application Support/Claude/config.json` |
| **Claude Desktop (Windows)** | `%APPDATA%\Claude\config.json` |
| **Gemini CLI** | 查看 Gemini CLI 文档 |
| **Warp** | 查看 Warp 的 MCP 集成文档 |
服务器从环境变量中读取 `SARVAM_API_KEY`。请勿在标头中发送 API 密钥。
---
## 🚦 快速入门指南
1. **克隆和构建：**
```bash
git clone https://github.com/JDhruv14/Sarvam-MCP.git
cd Sarvam-MCP
docker build -t sarvam .
```
2. **运行服务器：**
```bash
docker run -p 8080:8080 sarvam
```
3. **配置您的 MCP 客户端：** 将配置添加到客户端的 `config.json`
4. **测试连接：** 尝试简单的语言识别查询
---
## ⚠️ 重要注意事项
- **🔄 保持服务器运行：** 在使用 MCP 时，Docker 容器必须保持活动状态
- **🌐 网络访问：** 确保您的客户端应用程序可以访问端口 8080
- **🔐 API 身份验证：** 所有请求都需要有效的订阅密钥
- **🔄 客户端重启：** 在更新配置后重启您的 MCP 客户端
- **📱 ngrok URL：** 请记住，ngrok URL 每次重启 ngrok 时都会更改
---
## 🤝 贡献
我欢迎贡献！以下是开始贡献的方法：
1. **Fork** 仓库
2. **创建** 功能分支：
3. **提交** 您的更改：
4. **推送** 到分支：
5. **打开** 拉取请求
---
## 📄 许可证
该项目在 MIT 许可证下获得许可 - 有关详细信息，请参阅 [LICENSE](LICENSE) 文件。
---
**⭐ 如果您觉得这个项目有帮助，请在 GitHub 上给它一个星标！**
