actual-mcp-server 0.7.5 → 0.7.8
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 +19 -2
- package/dist/package.json +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -12,6 +12,7 @@
|
|
|
12
12
|
[](https://modelcontextprotocol.io/)
|
|
13
13
|
[](https://hub.docker.com/r/agigante80/actual-mcp-server)
|
|
14
14
|
[](https://hub.docker.com/r/agigante80/actual-mcp-server)
|
|
15
|
+
[](https://ca.unraid.net/apps/actual-mcp-server-0bghkvs0c7c8bg)
|
|
15
16
|
[](https://github.com/agigante80/actual-mcp-server/actions)
|
|
16
17
|
[](https://github.com/agigante80/actual-mcp-server)
|
|
17
18
|
|
|
@@ -55,7 +56,7 @@ Most Actual Budget MCP implementations are simple stdio bridges designed for sin
|
|
|
55
56
|
- [Available Tools](#available-tools)
|
|
56
57
|
- [Configuration](#configuration)
|
|
57
58
|
- [Multi-Budget Switching](#multi-budget-switching)
|
|
58
|
-
- [Transport & Authentication](#transport
|
|
59
|
+
- [Transport & Authentication](#transport--authentication)
|
|
59
60
|
- [Testing](#testing)
|
|
60
61
|
- [Documentation](#documentation)
|
|
61
62
|
- [Contributing](#contributing)
|
|
@@ -179,6 +180,22 @@ Add to `claude_desktop_config.json` (see [docs/guides/MCP_CLIENTS_SETUP.md](docs
|
|
|
179
180
|
>
|
|
180
181
|
> **`MCP_BRIDGE_DATA_DIR` should be an absolute path.** Without one, the data directory resolves relative to wherever the client spawns the process, which can be unpredictable. The directory is created automatically on first run.
|
|
181
182
|
|
|
183
|
+
### Option E: Unraid (Community Applications)
|
|
184
|
+
|
|
185
|
+
[](https://ca.unraid.net/apps/actual-mcp-server-0bghkvs0c7c8bg)
|
|
186
|
+
|
|
187
|
+
Actual MCP Server is published in the Unraid **Community Applications** store: **[ca.unraid.net/apps/actual-mcp-server](https://ca.unraid.net/apps/actual-mcp-server-0bghkvs0c7c8bg)**. This runs the HTTP transport, the right choice for LibreChat, LobeChat, and other remote MCP clients.
|
|
188
|
+
|
|
189
|
+
Install it from the **Apps** tab (Community Applications):
|
|
190
|
+
|
|
191
|
+
1. Open the **Apps** tab and search for **`actual-mcp-server`**, then click **Install**.
|
|
192
|
+
2. Fill in **Actual server URL**, **Actual server password**, and **Actual server Sync ID** (the Sync ID is in Actual Budget: open the budget, **Settings, Show advanced settings, Sync ID**).
|
|
193
|
+
3. **Set a strong MCP auth token.** Generate one with `openssl rand -hex 32`. A blank token disables all HTTP authentication and exposes your financial data unauthenticated on the LAN, so this is required (see [Transport & Authentication](#transport--authentication)).
|
|
194
|
+
4. Leave **PUID=99** and **PGID=100** (`nobody:users`) so the container can write the appdata Data and Logs directories, then start it.
|
|
195
|
+
5. Reach the health endpoint via the container's **WebUI** link (port `3600`); point your MCP client at `http://[server-ip]:3600/http` with the Bearer token.
|
|
196
|
+
|
|
197
|
+
The Unraid template lives in [`unraid/actual-mcp-server.xml`](unraid/actual-mcp-server.xml). For the publishing workflow see [docs/UNRAID_CA_PUBLISHING.md](docs/UNRAID_CA_PUBLISHING.md).
|
|
198
|
+
|
|
182
199
|
### Connect an AI client
|
|
183
200
|
|
|
184
201
|
**LibreChat / LobeChat**: add to `librechat.yaml` (or LobeChat MCP plugin settings):
|
|
@@ -698,4 +715,4 @@ The software is provided **as-is**, without warranty of any kind. The author acc
|
|
|
698
715
|
|
|
699
716
|
---
|
|
700
717
|
|
|
701
|
-
**Version:** 0.7.
|
|
718
|
+
**Version:** 0.7.8 | **Tool Count:** 71 (verified LibreChat-compatible)
|
package/dist/package.json
CHANGED