README.md
Enforces GINIALTECH project conventions and protects critical files.
ginialtech-mcp
MCP (Model Context Protocol) server for GINIALTECH projects. Enforces conventions, protects critical files and provides project context to AI agents.
Tools
`get_project_context`
Reads AI_CONTEXT.md from the current project and returns its contents. Searches in the project root first, then in docs/.
`get_protected_files`
Returns the list of files that should never be modified without explicit confirmation from the developer.
`validate_conventions`
Returns the mandatory conventions for all GINIALTECH projects:
- Package manager:
bunexclusively - Code and comments: English
- Plans, tasks and communication: Spanish (Argentina)
- Always plan before executing
- Never modify protected files without confirmation
Requirements
- Bun >= 1.0
Installation
git clone https://github.com/marcelaborgarello/ginialtech-mcp
cd ginialtech-mcp
bun install
Usage with Antigravity (Google AI Studio)
Add this to your mcp_config.json inside the mcpServers object:
"ginialtech-mcp": {
"$typeName": "exa.cascade_plugins_pb.CascadePluginCommandTemplate",
"command": "/absolute/path/to/bun",
"args": [
"run",
"/absolute/path/to/ginialtech-mcp/src/index.ts"
],
"env": {}
}
On Windows, use double backslashes:
C:\\Users\\youruser\\...
To find your bun path:
which bun # macOS/Linux
where bun # Windows
Usage with Claude Code / Cursor
Add to your MCP config:
"ginialtech-mcp": {
"command": "bun",
"args": ["run", "/absolute/path/to/ginialtech-mcp/src/index.ts"]
}
Project structure
ginialtech-mcp/
src/
index.ts ← MCP server and tools
package.json
tsconfig.json
README.md
License
MIT — GINIALTECH
Tools (3)
get_project_contextReads AI_CONTEXT.md from the project root or docs directory.get_protected_filesReturns a list of files that require explicit confirmation before modification.validate_conventionsReturns the mandatory project conventions for GINIALTECH projects.Configuration
claude_desktop_config.json
{"ginialtech-mcp": {"command": "bun", "args": ["run", "/absolute/path/to/ginialtech-mcp/src/index.ts"]}}Try it
→What are the mandatory project conventions I need to follow for this GINIALTECH project?
→Can you read the project context from AI_CONTEXT.md?
→Which files in this repository are protected and require confirmation before I edit them?
→Validate that my current project setup adheres to the GINIALTECH conventions.