@claudinho/mcp 0.1.1 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +36 -4
- package/dist/index.js +449 -138
- package/package.json +13 -12
package/README.md
CHANGED
|
@@ -28,6 +28,14 @@ args = ["-y", "@claudinho/mcp"]
|
|
|
28
28
|
```
|
|
29
29
|
(or `codex mcp add claudinho -- npx -y @claudinho/mcp`)
|
|
30
30
|
|
|
31
|
+
**Claude Desktop** — edit `claude_desktop_config.json` (Settings → Developer →
|
|
32
|
+
Edit Config), then restart Claude Desktop:
|
|
33
|
+
```json
|
|
34
|
+
{ "mcpServers": { "claudinho": { "command": "npx", "args": ["-y", "@claudinho/mcp"] } } }
|
|
35
|
+
```
|
|
36
|
+
Config location: macOS `~/Library/Application Support/Claude/claude_desktop_config.json`,
|
|
37
|
+
Windows `%APPDATA%\Claude\claude_desktop_config.json`.
|
|
38
|
+
|
|
31
39
|
Transport is stdio, so the same package works in Windsurf, Zed, VS Code, and
|
|
32
40
|
any other MCP client with no changes.
|
|
33
41
|
|
|
@@ -35,21 +43,41 @@ any other MCP client with no changes.
|
|
|
35
43
|
|
|
36
44
|
| Tool | What it does |
|
|
37
45
|
|---|---|
|
|
38
|
-
| `get_today` | fixtures for a date (default: today), live scores overlaid |
|
|
46
|
+
| `get_today` | fixtures for a date (default: today), grouped in the caller's `tz`, live scores overlaid |
|
|
39
47
|
| `get_live` | matches in play right now |
|
|
40
48
|
| `get_match` | a single match by id |
|
|
41
49
|
| `get_standings` | group table(s) — one group `A`–`L`, or all |
|
|
42
50
|
| `get_next_fixture` | a team's next match (3-letter code, e.g. `MEX`) |
|
|
43
51
|
|
|
44
52
|
All tools are **read-only** (annotated `readOnlyHint`) and accept optional
|
|
45
|
-
`tz` (IANA timezone)
|
|
46
|
-
includes both human-readable
|
|
53
|
+
`tz` (IANA timezone), `lang` (`en`/`es`/`pt`/`fr`), and `flavor`
|
|
54
|
+
(`off`/`subtle`/`full`) arguments. Each response includes both human-readable
|
|
55
|
+
text and structured JSON.
|
|
47
56
|
|
|
48
57
|
## Resources & prompts
|
|
49
58
|
|
|
50
|
-
- Resources: `standings://{group}` (e.g. `standings://A`), `fixtures://{date}` (e.g. `fixtures://2026-06-11`)
|
|
59
|
+
- Resources: `standings://{group}` (e.g. `standings://A`), `fixtures://{date}` (UTC date, e.g. `fixtures://2026-06-11`)
|
|
51
60
|
- Prompts: `tournament_today`, `my_team`
|
|
52
61
|
|
|
62
|
+
## Commentary flair
|
|
63
|
+
|
|
64
|
+
By default the server adds a light, localized football-commentary voice: each
|
|
65
|
+
match line in the text ends with a short genre-style exclamation (`— ¡GOOOOL!`),
|
|
66
|
+
and the server instructions nudge the model to narrate scores with matching
|
|
67
|
+
energy. The phrases are generic — no real commentator is quoted or impersonated —
|
|
68
|
+
and they never touch the structured JSON, so the facts stay clean.
|
|
69
|
+
|
|
70
|
+
Control it with `CLAUDINHO_FLAVOR` (`off` | `subtle` | `full`, default `full`),
|
|
71
|
+
or per call via the `flavor` tool argument. In Claude Code, add it to the `env`
|
|
72
|
+
block of your server entry:
|
|
73
|
+
|
|
74
|
+
```json
|
|
75
|
+
{ "mcpServers": { "claudinho": {
|
|
76
|
+
"command": "npx", "args": ["-y", "@claudinho/mcp"],
|
|
77
|
+
"env": { "CLAUDINHO_FLAVOR": "subtle" }
|
|
78
|
+
} } }
|
|
79
|
+
```
|
|
80
|
+
|
|
53
81
|
## Other competitions
|
|
54
82
|
|
|
55
83
|
By default the server follows the 2026 World Cup. Set the `CLAUDINHO_COMPETITION`
|
|
@@ -66,3 +94,7 @@ except the MCP protocol; diagnostics go to stderr.
|
|
|
66
94
|
## License
|
|
67
95
|
|
|
68
96
|
MIT © 2026 Arturo Garrido · [source & issues](https://github.com/arturogarrido/claudinho)
|
|
97
|
+
|
|
98
|
+
---
|
|
99
|
+
|
|
100
|
+
_Built while watching the games._ **#VibingLaVidaLoca** ⚽
|