@caseywebb/elm-package-mcp-server 0.3.0 → 0.5.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
CHANGED
|
@@ -1,5 +1,15 @@
|
|
|
1
1
|
# Elm Package MCP Server
|
|
2
2
|
|
|
3
|
+
> [!WARNING]
|
|
4
|
+
> **Deprecated:** This MCP server has been replaced by a Claude Code Skills-based plugin that provides the same functionality without requiring a separate server process.
|
|
5
|
+
>
|
|
6
|
+
> **To migrate**, invoke the `migrate-to-skills` prompt in Claude Code, or follow these steps:
|
|
7
|
+
> 1. `/plugin marketplace add caseyWebb/elm-claude-plugin`
|
|
8
|
+
> 2. `/plugin install elm@caseyWebb`
|
|
9
|
+
> 3. `claude mcp remove elm-packages`
|
|
10
|
+
>
|
|
11
|
+
> The new plugin requires `curl` and `jq` to be installed.
|
|
12
|
+
|
|
3
13
|
> [!CAUTION]
|
|
4
14
|
> This is vibe-coded. I barely know Rust. I've read the code, but use at your own risk.
|
|
5
15
|
|
|
@@ -21,37 +31,27 @@ An MCP (Model Context Protocol) server that provides tools for looking up Elm pa
|
|
|
21
31
|
|
|
22
32
|
### Using npx (Recommended)
|
|
23
33
|
|
|
24
|
-
The easiest way to use this MCP server is via npx (macOS only)
|
|
34
|
+
The easiest way to use this MCP server is via npx (macOS only).
|
|
35
|
+
|
|
36
|
+
#### Quick Setup with Claude Code
|
|
25
37
|
|
|
26
38
|
```bash
|
|
27
|
-
npx @caseywebb/elm-package-mcp-server
|
|
39
|
+
claude mcp add elm-packages npx @caseywebb/elm-package-mcp-server
|
|
28
40
|
```
|
|
29
41
|
|
|
30
|
-
|
|
42
|
+
#### Manual Configuration (.mcp.json)
|
|
31
43
|
|
|
32
44
|
```json
|
|
33
45
|
{
|
|
34
46
|
"mcpServers": {
|
|
35
47
|
"elm-package": {
|
|
36
48
|
"command": "npx",
|
|
37
|
-
"args": ["@caseywebb/elm-package-mcp-server"
|
|
49
|
+
"args": ["@caseywebb/elm-package-mcp-server"]
|
|
38
50
|
}
|
|
39
51
|
}
|
|
40
52
|
}
|
|
41
53
|
```
|
|
42
54
|
|
|
43
|
-
To configure with Zed:
|
|
44
|
-
|
|
45
|
-
```json
|
|
46
|
-
{
|
|
47
|
-
"elm-package": {
|
|
48
|
-
"command": "npx",
|
|
49
|
-
"args": ["@caseywebb/elm-package-mcp-server", "--mcp"],
|
|
50
|
-
"env": {}
|
|
51
|
-
}
|
|
52
|
-
}
|
|
53
|
-
```
|
|
54
|
-
|
|
55
55
|
### From GitHub Releases
|
|
56
56
|
|
|
57
57
|
The easiest way to install is to download a pre-built binary from the [latest release](https://github.com/caseyWebb/elm-package-mcp-server/releases/latest).
|
|
@@ -92,47 +92,6 @@ cargo build --release
|
|
|
92
92
|
|
|
93
93
|
The binary will be available at `target/release/elm-package-mcp-server`
|
|
94
94
|
|
|
95
|
-
## Configuration
|
|
96
|
-
|
|
97
|
-
### Claude Desktop
|
|
98
|
-
|
|
99
|
-
To use this MCP server with Claude Desktop, add the following to your Claude Desktop configuration:
|
|
100
|
-
|
|
101
|
-
1. Open Claude Desktop settings
|
|
102
|
-
2. Go to Developer → Edit Config
|
|
103
|
-
3. Add the following to the `mcpServers` section:
|
|
104
|
-
|
|
105
|
-
```json
|
|
106
|
-
{
|
|
107
|
-
"mcpServers": {
|
|
108
|
-
"elm-package": {
|
|
109
|
-
"command": "/path/to/elm-package-mcp-server",
|
|
110
|
-
"args": ["--mcp"]
|
|
111
|
-
}
|
|
112
|
-
}
|
|
113
|
-
}
|
|
114
|
-
```
|
|
115
|
-
|
|
116
|
-
Replace `/path/to/elm-package-mcp-server` with the actual path to your built binary.
|
|
117
|
-
|
|
118
|
-
### Zed
|
|
119
|
-
|
|
120
|
-
- Open the Assistant Panel (<kbd>Cmd</kbd>+<kbd>?</kbd>)
|
|
121
|
-
- Click "Add Custom Server..."
|
|
122
|
-
- Enter the following in the window that appears:
|
|
123
|
-
|
|
124
|
-
```json
|
|
125
|
-
{
|
|
126
|
-
"elm-package": {
|
|
127
|
-
"command": "/path/to/elm-package-mcp-server",
|
|
128
|
-
"args": ["--mcp"],
|
|
129
|
-
"env": {}
|
|
130
|
-
}
|
|
131
|
-
}
|
|
132
|
-
```
|
|
133
|
-
|
|
134
|
-
Replace `/path/to/elm-package-mcp-server` with the actual path to your built binary.
|
|
135
|
-
|
|
136
95
|
## Usage
|
|
137
96
|
|
|
138
97
|
The server must be run from a directory containing an elm.json file or any subdirectory of an Elm project. It will automatically find the elm.json file by searching up the directory tree.
|
|
@@ -298,7 +257,8 @@ Compare two Elm packages to help choose the best one for a specific use case.
|
|
|
298
257
|
|
|
299
258
|
## CLI Options
|
|
300
259
|
|
|
301
|
-
|
|
260
|
+
The server runs in MCP server mode by default. Use the following options to inspect the server's capabilities:
|
|
261
|
+
|
|
302
262
|
- `--tools`: Display available Elm package tools
|
|
303
263
|
- `--resources`: Display available resources
|
|
304
264
|
- `--prompts`: Display available prompts
|
|
@@ -329,10 +289,6 @@ just npm-test-local
|
|
|
329
289
|
just npm-publish
|
|
330
290
|
```
|
|
331
291
|
|
|
332
|
-
## Future Plans
|
|
333
|
-
|
|
334
|
-
This MCP server is designed to be shipped with a Zed extension, which will be developed in the same repository.
|
|
335
|
-
|
|
336
292
|
## License
|
|
337
293
|
|
|
338
294
|
Apache-2.0
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@caseywebb/elm-package-mcp-server",
|
|
3
3
|
"private": false,
|
|
4
|
-
"version": "0.
|
|
4
|
+
"version": "0.5.0",
|
|
5
5
|
"description": "Model Context Protocol (MCP) server for Elm language package documentation. Provides tools to list Elm packages from elm.json and fetch README/API docs from package.elm-lang.org",
|
|
6
6
|
"bin": {
|
|
7
7
|
"elm-package-mcp-server": "./bin/cli.js"
|