brewers-almanack 0.1.0 → 0.1.1
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 +10 -7
- package/dist/index.js +12 -2
- package/dist/index.js.map +1 -1
- package/dist/server.d.ts +1 -1
- package/dist/server.js +2 -2
- package/dist/server.js.map +1 -1
- package/package.json +12 -4
package/README.md
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
|
+
<!-- mcp-name: io.github.gregario/brewers-almanack -->
|
|
1
2
|
<p align="center">
|
|
2
3
|
<h1 align="center">Brewers Almanack</h1>
|
|
3
|
-
<p align="center">A brewing knowledge MCP server
|
|
4
|
+
<p align="center">A brewing knowledge MCP server: beer styles, ingredients, off-flavour diagnosis, water chemistry, and recipe guidance for AI assistants.</p>
|
|
4
5
|
</p>
|
|
5
6
|
|
|
6
7
|
<p align="center">
|
|
@@ -13,10 +14,12 @@
|
|
|
13
14
|
|
|
14
15
|
---
|
|
15
16
|
|
|
16
|
-
Ask your AI assistant about beer styles, diagnose off-flavours, build recipes, match water profiles, and pair food
|
|
17
|
+
Ask your AI assistant about beer styles, diagnose off-flavours, build recipes, match water profiles, and pair food (all backed by real brewing data, not hallucinations).
|
|
17
18
|
|
|
18
19
|
**6 tools. Zero config. Works with every MCP-compatible IDE.**
|
|
19
20
|
|
|
21
|
+
[](https://glama.ai/mcp/servers/gregario/brewers-almanack)
|
|
22
|
+
|
|
20
23
|
## Install
|
|
21
24
|
|
|
22
25
|
```bash
|
|
@@ -131,16 +134,16 @@ Add to `settings.json`:
|
|
|
131
134
|
## Example Conversations
|
|
132
135
|
|
|
133
136
|
**"What hops work in a Belgian Dubbel?"**
|
|
134
|
-
> Searches ingredients for hops that complement Belgian styles
|
|
137
|
+
> Searches ingredients for hops that complement Belgian styles, returning varieties like Styrian Goldings and Saaz with alpha acid ranges, aromas, and substitutes.
|
|
135
138
|
|
|
136
|
-
**"My beer tastes like butter
|
|
139
|
+
**"My beer tastes like butter, what went wrong?"**
|
|
137
140
|
> Diagnoses diacetyl: identifies the compound, explains causes (incomplete fermentation, premature racking), and gives prevention steps (diacetyl rest, healthy yeast pitch).
|
|
138
141
|
|
|
139
142
|
**"Suggest a recipe for a West Coast IPA"**
|
|
140
143
|
> Builds a complete recipe: pale malt base with crystal malt, Centennial/Cascade hop schedule with dry hop additions, American ale yeast, and a Burton-style water profile.
|
|
141
144
|
|
|
142
145
|
**"What food pairs well with a stout?"**
|
|
143
|
-
> Returns pairing suggestions
|
|
146
|
+
> Returns pairing suggestions (oysters, chocolate desserts, grilled meats) with principles explaining why each pairing works (complement, contrast, or cleanse).
|
|
144
147
|
|
|
145
148
|
## Data Sources
|
|
146
149
|
|
|
@@ -161,7 +164,7 @@ See [ROADMAP.md](ROADMAP.md) for planned features: brewing calculators, recipe i
|
|
|
161
164
|
|
|
162
165
|
## Contributing
|
|
163
166
|
|
|
164
|
-
Contributions are welcome
|
|
167
|
+
Contributions are welcome, especially data contributions. More hop varieties, yeast strains, regional water profiles, and food pairings make the server more useful for everyone.
|
|
165
168
|
|
|
166
169
|
```bash
|
|
167
170
|
git clone https://github.com/gregario/brewers-almanack.git
|
|
@@ -181,4 +184,4 @@ See [ROADMAP.md](ROADMAP.md) for areas where contributions are most needed.
|
|
|
181
184
|
|
|
182
185
|
## Licence
|
|
183
186
|
|
|
184
|
-
[MIT](LICENSE)
|
|
187
|
+
[MIT](LICENSE)
|
package/dist/index.js
CHANGED
|
@@ -1,8 +1,18 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
+
import { readFileSync } from "node:fs";
|
|
2
3
|
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
|
|
3
4
|
import { createServer } from "./server.js";
|
|
4
|
-
|
|
5
|
-
|
|
5
|
+
const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
|
|
6
|
+
console.error(`Brewers Almanack v${pkg.version} — brewing knowledge MCP server`);
|
|
7
|
+
const server = createServer(pkg.version);
|
|
6
8
|
const transport = new StdioServerTransport();
|
|
7
9
|
await server.connect(transport);
|
|
10
|
+
process.on("SIGINT", async () => {
|
|
11
|
+
await server.close();
|
|
12
|
+
process.exit(0);
|
|
13
|
+
});
|
|
14
|
+
process.on("SIGTERM", async () => {
|
|
15
|
+
await server.close();
|
|
16
|
+
process.exit(0);
|
|
17
|
+
});
|
|
8
18
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,CAAC,KAAK,CAAC,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAE3F,OAAO,CAAC,KAAK,CAAC,qBAAqB,GAAG,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAEjF,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACzC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAEhC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;IAC9B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;IAC/B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
|
package/dist/server.d.ts
CHANGED
package/dist/server.js
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
2
|
import { registerTools } from "./register-tools.js";
|
|
3
|
-
export function createServer() {
|
|
3
|
+
export function createServer(version) {
|
|
4
4
|
const server = new McpServer({
|
|
5
5
|
name: "brewers-almanack",
|
|
6
|
-
version: "0.
|
|
6
|
+
version: version ?? "0.0.0",
|
|
7
7
|
});
|
|
8
8
|
registerTools(server);
|
|
9
9
|
return server;
|
package/dist/server.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,UAAU,YAAY;
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,OAAO,IAAI,OAAO;KAC5B,CAAC,CAAC;IACH,aAAa,CAAC,MAAM,CAAC,CAAC;IACtB,OAAO,MAAM,CAAC;AAChB,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "brewers-almanack",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "A brewing knowledge MCP server — beer styles, ingredients, off-flavour diagnosis, water chemistry, and recipe guidance for AI brewing assistants",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -25,15 +25,23 @@
|
|
|
25
25
|
"node": ">=18.0.0"
|
|
26
26
|
},
|
|
27
27
|
"keywords": [
|
|
28
|
-
"mcp",
|
|
29
|
-
"
|
|
28
|
+
"mcp",
|
|
29
|
+
"brewing",
|
|
30
|
+
"beer",
|
|
31
|
+
"homebrew",
|
|
32
|
+
"bjcp",
|
|
33
|
+
"recipe",
|
|
34
|
+
"model-context-protocol",
|
|
35
|
+
"hops",
|
|
36
|
+
"malt",
|
|
37
|
+
"yeast"
|
|
30
38
|
],
|
|
31
39
|
"mcpName": "io.github.gregario/brewers-almanack",
|
|
32
40
|
"author": "gregario",
|
|
33
41
|
"license": "MIT",
|
|
34
42
|
"repository": {
|
|
35
43
|
"type": "git",
|
|
36
|
-
"url": "https://github.com/gregario/brewers-almanack"
|
|
44
|
+
"url": "git+https://github.com/gregario/brewers-almanack.git"
|
|
37
45
|
},
|
|
38
46
|
"dependencies": {
|
|
39
47
|
"@modelcontextprotocol/sdk": "^1.12",
|