Skip to content

Commit 559206a

Browse files
authored
Merge pull request #10 from cyclimse/docs/crush-readme
docs: add stdio example with crush on readme
2 parents 20e25b6 + ebfe94e commit 559206a

File tree

1 file changed

+59
-4
lines changed

1 file changed

+59
-4
lines changed

README.md

Lines changed: 59 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -20,10 +20,13 @@ Run the MCP server:
2020

2121
By default, the MCP server runs with the SSE transport on `http://localhost:8080`, but you can also change it to use Standard I/O (stdio) transport via the `--transport stdio` flag.
2222

23-
Then, configure your IDE to use the MCP server. Here's an example with VSCode and GitHub Copilot:
23+
Then, configure your IDE or tool of choice to connect to the MCP server. Here are some examples:
2424

25-
```jsonc
26-
// In .vscode/mcp.json
25+
### VSCode (sse example)
26+
27+
Add a new server configuration in your `.vscode/mcp.json` file:
28+
29+
```json
2730
{
2831
"servers": {
2932
"mcp-scaleway-functions": {
@@ -34,11 +37,63 @@ Then, configure your IDE to use the MCP server. Here's an example with VSCode an
3437
}
3538
```
3639

40+
### Crush (stdio example)
41+
42+
Crush is an open-source coding agent that supports MCP. You can find more information about in the [Crush repository](https://github.com/charmbracelet/crush).
43+
44+
Add a new server configuration in your `~/.config/crush/config.json` file:
45+
46+
```json
47+
{
48+
"$schema": "https://charm.land/crush.json",
49+
"mcp": {
50+
"scaleway-functions": {
51+
"type": "stdio",
52+
"command": "mcp-scaleway-functions",
53+
"args": ["--transport", "stdio"],
54+
"timeout": 600,
55+
"disabled": false
56+
}
57+
}
58+
}
59+
```
60+
61+
You can even use Crush with [Scaleway Generative APIs](https://www.scaleway.com/en/generative-apis/) by adding a new provider in the same `~/.config/crush/config.json` file:
62+
63+
```jsonc
64+
{
65+
"mcp": {
66+
// ... see above ...
67+
},
68+
"providers": {
69+
"scaleway": {
70+
"name": "Scaleway",
71+
"base_url": "https://api.scaleway.ai/v1/",
72+
"type": "openai",
73+
// To fetch from environment variables, use the `$VAR_NAME` syntax.
74+
// Note: this key requires the "GenerativeApisModelAccess" permission.
75+
"api_key": "$SCW_SECRET_KEY",
76+
"models": [
77+
{
78+
"name": "Qwen coder",
79+
"id": "qwen3-coder-30b-a3b-instruct",
80+
"context_window": 128000,
81+
"default_max_tokens": 8000
82+
}
83+
]
84+
}
85+
}
86+
}
87+
```
88+
3789
That's it 🎉! Have fun vibecoding and vibedevoopsing as you please.
3890

3991
## Configuration
4092

41-
You can use the standard [Scaleway environment variables](https://www.scaleway.com/en/docs/scaleway-cli/reference-content/environment-variables/) to configure the MCP server.
93+
By default, the MCP server reads from the standard Scaleway configuration file located at `~/.config/scw/config.yaml`.
94+
95+
Further configuration can be done via the
96+
[Scaleway environment variables](https://www.scaleway.com/en/docs/scaleway-cli/reference-content/environment-variables/) to configure the MCP server.
4297

4398
For instance, you can set a region to work in via the `SCW_DEFAULT_REGION` environment variable.
4499

0 commit comments

Comments
 (0)