← Back to Skills Marketplace
RuRussian MCP
by
shuyueW1991
· GitHub ↗
· v2.0.0
· MIT-0
221
Downloads
0
Stars
0
Active Installs
8
Versions
Install in OpenClaw
/install rurussian-mcp
Description
Turn an OpenClaw bot into a Russian tutor with vocabulary analysis, sentence breakdowns, paid activation, be able to help create and betterize russiandiction...
Usage Guidance
This package appears to be a coherent RuRussian MCP, but consider the following before installing: (1) it requires and uses a RURUSSIAN_API_KEY and will communicate with the configured API endpoint (default https://rurussian.com/api) — only provide keys you trust; (2) it stores learner memory by default under ~/.rurussian_mcp/learning_memory.json — review and back up or change the path if you don’t want local data written to your home directory; (3) the skill supports hosted checkout and the docs describe letting a 'payment-capable bot' complete purchases — do not grant bots unattended payment authority, and never send raw card details through chat; (4) install in a virtualenv or isolated environment and verify the upstream repository and package authenticity (check the GitHub repo and package maintainer) before using; (5) if you need stronger guarantees, inspect the omitted files or run the package in a sandbox to watch network activity (it will contact the configured API and any override endpoints). Overall the package is internally consistent with its stated purpose, but exercise normal operational caution around API keys, local storage, and automated purchase flows.
Capability Analysis
Type: OpenClaw Skill
Name: rurussian-mcp
Version: 2.0.0
The rurussian-mcp skill bundle is a legitimate Russian language learning tool providing NLP-based features such as sentence parsing, vocabulary analysis, and lesson generation. It includes a subscription management system that allows agents to facilitate service activation through rurussian.com via hosted checkout URLs. The code is well-structured, uses standard libraries (httpx, pydantic, pymorphy3), and implements security best practices such as API key redaction in auth_service.py. No evidence of malicious intent, data exfiltration, or harmful prompt injection was found; the local file operations in memory_service.py are limited to maintaining learner progress in ~/.rurussian_mcp/.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description, required binary (rurussian-mcp), declared primaryEnv (RURUSSIAN_API_KEY), and the included Python package all align with a tutor/learning MCP that calls a remote rurussian.com backend and offers local learner memory and lesson tooling.
Instruction Scope
SKILL.md and the code implement expected operations: authenticate with an API key, call vocabulary/sentence/analysis endpoints, generate practice content, and run hosted checkout flows. The purchase/checkout tooling means an agent can open hosted payment URLs and confirm purchases (the docs explicitly describe letting a payment-capable bot complete checkout). This is within the skill's purpose but raises an operational note: granting a bot 'payment authority' is a separate risk the operator must manage; the skill itself instructs not to ask users for raw card details and attempts to redact API keys.
Install Mechanism
Install spec references a pip-installable package (rurussian-mcp) that is included in the bundle (pyproject.toml and package files present). No remote arbitrary-download URLs or obfuscated installers were used in the manifest; installation is standard Python packaging.
Credentials
The declared primaryEnv is RURUSSIAN_API_KEY and optional env vars (RURUSSIAN_API_URL, memory store path, purchase endpoints) are appropriate for a service client. There are no unrelated credentials or unexpected environment variables requested.
Persistence & Privilege
The MCP writes persistent learner memory to a file in the user's home directory (~/.rurussian_mcp/learning_memory.json by default) and keeps purchase_context in-memory; this is coherent for a tutoring MCP but is a persistent artifact on disk. The skill is not always-on and does not request elevated system privileges, but you should be aware of local storage and checkout behavior (agents can initiate/confirm purchases if granted payment authority).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install rurussian-mcp - After installation, invoke the skill by name or use
/rurussian-mcp - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.0
Major refactor and expansion of functionality.
- Modularized codebase: Added new directories for config, memory, schemas, services, and tools.
- Introduced multiple new files for services, tool logic, schemas, and examples.
- Updated and refactored core server logic.
- Expanded project structure for clearer separation of API, services, and tools.
v1.0.7
- Expanded support to include Rusvibe sentence flows and Zakuska reading practice with enhanced learner context.
- Added ability to pull saved Rusvibe sentences for a learner and to generate Zakuska content in various modes.
- Improved tool parameters for get_sentences (now supports email, saved_only, wait, and polling options).
- Updated documentation and skill description to reflect enhanced capabilities, especially around russiandictionary and Rusvibe integration.
- Minor routing and usage guidance updates for OpenClaw agents.
v1.0.6
- Added native support for bot-driven purchase flows, including plan listing, checkout, and confirmation tools.
- Expanded instructions to cover bot API key setup, hosted checkout, and self-serve session unlock for OpenClaw bots.
- New tool: list_pricing_plans for plan discovery and automated activation.
- Improved authentication and purchase error handling, with clear steps for bot-based activation and status checks.
- Updated documentation for agent workflows, recommended tool chaining, and safe usage guidelines.
v1.0.4
- Internal updates to codebase: pyproject.toml and rurussian_mcp/server.py modified.
- No user-facing changes or documentation updates.
- Version incremented to 1.0.4.
v1.0.3
Version 1.0.3
- Updated SKILL.md with enhanced security and workflow guidance: clarified not to expose API keys or request payment details from users.
- Added explicit instructions to only use purchase flow when user asks to buy a plan.
- Added version and more detailed metadata for OpenClaw integration.
- Improved error handling and agent guidance in recommended workflow.
- Documentation updates across README.md, INTEGRATION.md, and config example files.
v1.0.2
- Added in-skill API key purchase flow: users can now start and confirm plan purchases directly from the MCP.
- New tools: `authentication_status`, `create_key_purchase_session`, and `confirm_key_purchase` for full self-serve onboarding.
- Setup instructions updated to include purchase endpoints and default API URL, clarifying configuration variables.
- Workflow guidance improved for handling authentication and purchase processes.
- Failure handling section expanded for purchase-related errors.
v1.0.1
- Documentation updated: minor revisions to README.md and INTEGRATION.md.
- Removed maintenance and patch-related files (MAINTENANCE.md, several patch_* files), cleaning up the repository.
- No changes to functionality or usage.
v1.0.0
- Initial release of rurussian-mcp: an MCP server for accessing Russian language resources and tools.
- Provides endpoints for vocabulary lookup, grammar analysis, example sentences, reading practice content, and translation.
- Requires API key authentication at the start of each session.
- Clear routing guide to select the right tool for each learner request.
- Includes setup instructions for integration and usage with OpenClaw or compatible clients.
Metadata
Frequently Asked Questions
What is RuRussian MCP?
Turn an OpenClaw bot into a Russian tutor with vocabulary analysis, sentence breakdowns, paid activation, be able to help create and betterize russiandiction... It is an AI Agent Skill for Claude Code / OpenClaw, with 221 downloads so far.
How do I install RuRussian MCP?
Run "/install rurussian-mcp" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is RuRussian MCP free?
Yes, RuRussian MCP is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does RuRussian MCP support?
RuRussian MCP is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created RuRussian MCP?
It is built and maintained by shuyueW1991 (@shuyuew1991); the current version is v2.0.0.
More Skills