🇱🇰 僧伽罗语mcp

🚀 斯里兰卡首个面向僧伽罗语开发者的人工智能MCP服务器

打破语言障碍。用母语编写代码。

](https://pypi.org/project/sinhala-mcp/) ](https://www.python.org/downloads/) ![License](LICENSE) ![MCP](https://modelcontextprotocol.io/) ![Made in Sri Lanka](https://github.com/Thamindu-Dev/sinhala-mcp)

一个生产就绪的模型上下文协议服务器，使用谷歌Gemini AI将僧伽罗语/新加坡英语指令翻译成精确的英语技术规范。

______________________________________________________________________

注释（v0.1.8+）：此README的先前版本记录了导致无声故障的不正确配置方法。以下方法已经过测试和验证。如果您之前使用旧的说明配置了sinhala mcp，请删除旧的配置并按照以下更新的步骤进行操作。

为什么选择僧伽罗语mcp？

随着 斯里兰卡首创, sinhala-mcp 赋予说僧伽罗语的开发人员以下权力：

用您喜欢的语言（僧伽罗语或新加坡英语）自然编码
获得针对AI编码代理优化的精确技术翻译
通过消除开发工作流程中的语言摩擦来提高生产力
通过谷歌的Gemini，保持领先的人工智能集成

特性

僧伽罗语/新加坡英语翻译：将口语命令转换为结构化的英语技术规范
上下文感知：自动推断技术上下文（例如“登录”→ “身份验证流程”）
环境变量认证：通过环境变量实现安全的API密钥管理
生产就绪：全面的错误处理、重试逻辑、超时保护、输入验证和健康检查
符合MCP标准：可与Claude Desktop、VS Code、Claude Code CLI和其他MCP兼容工具配合使用
最新AI：使用Google GenAI SDK与Gemini型号配合使用（支持1.5flash、2.5flash、2.5flash-lite、2.5-pro）

安装

pip install sinhala-mcp

或者使用紫外线：

uv pip install sinhala-mcp

从源手动安装

如果您在安装PyPI时遇到问题：

git clone https://github.com/Thamindu-Dev/sinhala-mcp.git
cd sinhala-mcp
pip install -e .

验证安装

安装后，验证服务器是否可访问：

sinhala-mcp --help

如果返回帮助消息，则表示该包已正确安装，并且可以在PATH中使用。

windows用户：如果 sinhala-mcp 找不到，Python脚本目录可能不在您的PATH中。可执行文件位于 C:\Users\\AppData\Local\Programs\Python\PythonXX\Scripts\sinhala-mcp.exe 哪里 XX 是你的Python版本（例如。， Python313).看故障排除了解详情。

配置

步骤1：获取Google Gemini API密钥

访问 Google AI 工作室
创建新的API密钥
保持安全——永远不要将其提交给版本控制

步骤2：配置MCP客户端

重要：服务器从 GEMINI_API_KEY 环境变量。没有此密钥，服务器将无法连接——您将看到 “重新连接失败” 在MCP客户端中，没有明确的错误消息。

______________________________________________________________________

方法1:克劳德代码CLI（推荐）

将僧伽罗语mcp添加到克劳德代码的最快方法：

claude mcp add sinhala-mcp -e GEMINI_API_KEY=your-api-key-here -- sinhala-mcp

对于特定的Gemini型号：

claude mcp add sinhala-mcp -e GEMINI_API_KEY=your-key -e GEMINI_MODEL=gemini-2.5-flash-lite -- sinhala-mcp

这有什么作用：将服务器配置写入 ~/.claude.json 在...之下 mcpServers 钥匙。这是Claude Code的正确配置文件——不要使用 ~/.claude/settings.json （不支持MCP服务器）或 ~/.claude/.mcp.json.

要验证是否已添加：

claude mcp list

要稍后删除它，请执行以下操作：

claude mcp remove sinhala-mcp

手动克劳德代码配置

如果您更喜欢直接编辑配置文件：

macOS/Linux: ~/.claude.json 视窗: %USERPROFILE%\.claude.json

在下面添加 "mcpServers" 按键：

{
  "mcpServers": {
    "sinhala-mcp": {
      "type": "stdio",
      "command": "sinhala-mcp",
      "args": [],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

windows用户：如果 sinhala-mcp 不在PATH中，请使用完整路径： ``json "command": "C:\\Users\\\\AppData\\Local\\Programs\\Python\\Python313\\Scripts\\sinhala-mcp.exe" ` 替换 使用您的Windows用户名和 Python313` 使用您安装的Python版本。

项目特定配置

要仅为特定项目添加sinhala mcp，请导航到项目目录并运行：

claude mcp add sinhala-mcp -e GEMINI_API_KEY=your-key -s project -- sinhala-mcp

或者手动将其添加到中的项目条目中 ~/.claude.json 在...之下 " " → "mcpServers".

______________________________________________________________________

方法2：克劳德桌面

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sinhala-mcp": {
      "type": "stdio",
      "command": "sinhala-mcp",
      "args": [],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

可选的：通过添加来覆盖默认模型 "GEMINI_MODEL": "gemini-2.5-flash-lite" 到env。

______________________________________________________________________

方法3:VS代码MCP扩展

创建或更新 .vscode/settings.json:

{
  "mcp.servers": {
    "sinhala-mcp": {
      "command": "sinhala-mcp",
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

要使用模型采样进行高级配置，请创建 .vscode/mcp.json:

{
  "servers": {
    "sinhala-mcp": {
      "command": "uvx",
      "args": ["sinhala-mcp"],
      "env": {
        "GEMINI_API_KEY": "${input:gemini_api_key}",
        "GEMINI_MODEL": "${input:gemini_model}"
      },
      "type": "stdio"
    }
  },
  "inputs": [
    {
      "id": "gemini_api_key",
      "type": "promptString",
      "description": "Google Gemini API Key",
      "default": ""
    },
    {
      "id": "gemini_model",
      "type": "promptString",
      "description": "Gemini Model (optional)",
      "default": "gemini-2.5-flash"
    }
  ]
}

然后更新 .vscode/settings.json 对于模型采样：

{
  "chat.mcp.serverSampling": {
    "sinhala-mcp/.vscode/mcp.json: sinhala-mcp": {
      "allowedModels": [
        "copilot/auto",
        "gemini-1.5-flash",
        "gemini-2.5-flash",
        "gemini-2.5-flash-lite",
        "gemini-2.5-pro"
      ]
    }
  }
}

______________________________________________________________________

可用工具

翻译_僧伽罗语_说明

将僧伽罗语或新加坡式英语指令翻译成精确的英语技术提示。

用途：

Use translate_sinhala_instruction to translate "mata login form ekak hadanna one"

参数：

instruction （字符串，必填）：僧伽罗语或新加坡式英语指令（最多5000个字符）

输出示例：

Original (Sinhala/Singlish):
mata login page ekak hadanna one

Translated (English Technical Prompt):
Implement a user authentication system with login functionality including:
- Username/email and password input fields
- Form validation for credentials
- Authentication endpoint integration
- Session management after successful login
- Error handling for failed authentication attempts

健康检查

检查MCP服务器和Gemini API连接是否正常工作。

用途：

Run health_check

用法示例

网站开发

输入： “Mata仪表板ekak denna用户统计显示karanna” 输出：

Create a user analytics dashboard with:
- Real-time user statistics display
- Data visualization charts
- Filtering and search capabilities
- Responsive layout for mobile/desktop
- Authentication-protected access

后端开发

输入： “数据库eka connect karanna API端点ekak hadala denna” 输出：

Implement database integration with REST API:
- Set up database connection pool
- Create CRUD endpoints for data access
- Implement proper error handling
- Add data validation and sanitization
- Include authentication/authorization middleware

前端功能

输入： “个人资料页面eke照片上传eka hadanna” 输出：

Implement profile photo upload feature:
- File upload input with image type validation
- Client-side image preview
- Size and format restrictions
- Upload progress indicator
- Server-side file storage integration
- Error handling for upload failures

发展

# Clone the repository
git clone https://github.com/Thamindu-Dev/sinhala-mcp.git
cd sinhala-mcp

# Install in editable mode
pip install -e .

# Test server
python test_simple.py

项目结构

sinhala-mcp/
├── src/
│   └── sinhala_mcp/
│       ├── __init__.py
│       └── server.py          # Main MCP server implementation
├── pyproject.toml              # Package configuration
├── README.md
└── LICENSE

安全

API密钥仅存储在环境变量中
没有本地文件存储凭据
输入验证和净化
防止注射攻击
费率限制处理
开源——完全可审计

技术规格

构建后端：幼龟
Python版本：3.10+（3.10-3.13测试）
依赖项: mcp>=0.9.0, google-genai>=1.0.0, google-api-core>=1.0.0
默认模型: gemini-2.5-flash
支持的型号: gemini-2.5-flash, gemini-2.5-flash-lite, gemini-2.5-pro, gemini-1.5-flash
最大指令长度：5000个字符
API超时：30秒
重试逻辑：2次重试，采用指数回退

故障排除

克劳德代码/克劳德桌面中的“重新连接失败”

这是 最常见的问题 有两个根本原因：

缺失 GEMINI_API_KEY：服务器在没有API密钥的情况下无法以静默方式启动。您不会看到一个明确的错误——只是“重新连接失败”。
过时的Python路径（Windows）如果你升级了Python command 配置中的路径指向旧版本（例如。， Python310 而不是 Python313).旧路径中不再存在可执行文件，因此服务器无法启动。这是用户报告的主要问题-- 旧文档没有考虑Windows上Python版本路径的更改.

修复：确保设置了API密钥和正确的可执行路径：

{
  "mcpServers": {
    "sinhala-mcp": {
      "type": "stdio",
      "command": "C:\\Users\\\\AppData\\Local\\Programs\\Python\\Python313\\Scripts\\sinhala-mcp.exe",
      "args": [],
      "env": {
        "GEMINI_API_KEY": "your-actual-key-here"
      }
    }
  }
}

视窗：始终验证路径是否存在。跑 where sinhala-mcp 在终端中找到正确的路径。如果你升级了Python，旧的路径将无法使用——请参阅 Python版本路径更改在......下面

更新配置后，重新启动Claude Code/Claude Desktop。

未找到“sinhala mcp”命令

原因：Python脚本目录不在您的系统PATH中，或者该包安装在不同的Python版本下。

修复（Windows）：使用可执行文件的完整路径：

C:\Users\\AppData\Local\Programs\Python\PythonXX\Scripts\sinhala-mcp.exe

替换 ` 使用您的用户名和 XX 使用Python版本文件夹（例如。， Python313`).

修复（macOS/Linux）：查找可执行文件路径：

which sinhala-mcp
# or
python -c "import shutil; print(shutil.which('sinhala-mcp'))"

如果需要，请在MCP配置中使用完整路径。

Python版本路径更改（Windows）

这是Windows上“重新连接失败”的首要原因。

当你升级Python（例如3.10）时→ 3.13),pip将软件包安装到新版本的Scripts目录中。旧的可执行路径无效：

Python 3.10: C:\...\Python310\Scripts\sinhala-mcp.exe
Python 3.13: C:\...\Python313\Scripts\sinhala-mcp.exe

如果您的MCP配置指向旧路径，服务器将无法启动。在新的Python版本上重新安装包，并更新配置中的路径：

# Reinstall on new Python
pip install sinhala-mcp

# Update config with new path
claude mcp remove sinhala-mcp
claude mcp add sinhala-mcp -e GEMINI_API_KEY=your-key -- "C:\Users\\AppData\Local\Programs\Python\Python313\Scripts\sinhala-mcp.exe"

VS代码兼容性问题

一些VS Code MCP扩展具有模型验证限制
权变措施：设置 GEMINI_MODEL=gemini-1.5-flash 在您的配置中实现更好的兼容性
重要：更改后 GEMINI_MODEL，重新启动MCP客户端以使更改生效
替代：使用Claude Desktop或Claude Code CLI以获得更好的兼容性

模型更改未生效

问题：设置 GEMINI_MODEL 不会改变正在使用的模型
解决方案：修改环境变量后重新启动MCP客户端（Claude Desktop，VS Code）
验证：启动时检查MCP服务器日志中的“正在使用Gemini型号：…”消息

翻译问题

由于安全设置，模型可能会阻止内容
试着重新表述指令

配置文件位置错误（Claude代码）

Claude Code从以下位置读取MCP服务器 ~/.claude.json （the "mcpServers" 顶层按键），不发件人：

~/.claude/settings.json --此文件仅包含环境变量和插件等设置，不包含MCP服务器
~/.claude/.mcp.json --这不是有效的Claude代码配置位置
.claude/settings.local.json --这仅保留每个项目的权限

使用 claude mcp add 正确添加服务器或编辑 ~/.claude.json 直接。

支持

报告问题:
MCP协议: 模型上下文协议.io

贡献

欢迎投稿！分叉存储库，创建功能分支，并提交Pull Request。

许可证

MIT许可证——见许可证了解详情。

关于开发者

僧伽罗语mcp 由创建 Thamindu Hatharasinghe --一位充满激情的斯里兰卡开发者，致力于打破技术中的语言障碍。

作为 斯里兰卡首个面向开发人员的僧伽罗语到英语技术翻译工具，该项目是使全球讲僧伽罗语的开发人员能够使用人工智能辅助开发的一个里程碑。

投资组合: www.thamindu.synthlab.com
GitHub: Thamindu Dev

______________________________________________________________________

斯里兰卡制造，面向全球僧伽罗语开发者

Sinhala MCP

快速接入

详细介绍

🇱🇰 僧伽罗语mcp

🚀 斯里兰卡首个面向僧伽罗语开发者的人工智能MCP服务器

为什么选择僧伽罗语mcp？

特性

安装

从源手动安装

验证安装

配置

步骤1：获取Google Gemini API密钥

步骤2：配置MCP客户端

方法1:克劳德代码CLI（推荐）

手动克劳德代码配置

项目特定配置

方法2：克劳德桌面

方法3:VS代码MCP扩展

可用工具

翻译_僧伽罗语_说明

健康检查

用法示例

网站开发

后端开发

前端功能

发展

项目结构

安全

技术规格

故障排除

克劳德代码/克劳德桌面中的“重新连接失败”

未找到“sinhala mcp”命令

Python版本路径更改（Windows）

VS代码兼容性问题

模型更改未生效

翻译问题

配置文件位置错误（Claude代码）

支持

贡献

许可证

关于开发者

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP