https://github.com/timescale/tiger-memory-mcp-server
A simple memory implementation
https://github.com/timescale/tiger-memory-mcp-server
Last synced: 3 months ago
JSON representation
A simple memory implementation
- Host: GitHub
- URL: https://github.com/timescale/tiger-memory-mcp-server
- Owner: timescale
- Created: 2025-08-25T20:59:32.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-09-18T22:17:40.000Z (4 months ago)
- Last Synced: 2025-09-19T00:38:42.555Z (4 months ago)
- Language: TypeScript
- Size: 66.4 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Tiger Memory MCP Server
A simple memory system designed to allow LLMs to store and retrieve information. This provides some focused tools to LLMs via the [Model Context Protocol](https://modelcontextprotocol.io/introduction).
## API
All methods are exposed as MCP tools and REST API endpoints.
## Development
Cloning and running the server locally.
```bash
git clone git@github.com:timescale/tiger-memory-mcp-server.git
```
### Building
Run `npm i` to install dependencies and build the project. Use `npm run watch` to rebuild on changes.
Create a `.env` file based on the `.env.sample` file.
```bash
cp .env.sample .env
```
### Testing
The MCP Inspector is very handy.
```bash
npm run inspector
```
| Field | Value |
| -------------- | --------------- |
| Transport Type | `STDIO` |
| Command | `node` |
| Arguments | `dist/index.js` |
#### Testing in Claude Desktop
Create/edit the file `~/Library/Application Support/Claude/claude_desktop_config.json` to add an entry like the following, making sure to use the absolute path to your local `tiger-memory-mcp-server` project, and real database credentials.
```json
{
"mcpServers": {
"tiger-memory": {
"command": "node",
"args": [
"/absolute/path/to/tiger-memory-mcp-server/dist/index.js",
"stdio"
],
"env": {
"PGHOST": "x.y.tsdb.cloud.timescale.com",
"PGDATABASE": "tsdb",
"PGPORT": "32467",
"PGUSER": "readonly_mcp_user",
"PGPASSWORD": "abc123"
}
}
}
}
```
## Deployment
We use a Helm chart to deploy to Kubernetes. See the `chart/` directory for details.
The service is accessible to other services in the cluster via the DNS name `tiger-memory-mcp-server.savannah-system.svc.cluster.local`.
### Database setup
Creating the database user:
```sql
CREATE USER tiger_memory WITH PASSWORD 'secret';
GRANT CREATE ON DATABASE tsdb TO tiger_memory;
```
### Secrets
Run the following to create the necessary sealed secrets. Be sure to fill in the correct values.
```bash
kubectl -n savannah-system create secret generic tiger-memory-mcp-server-database \
--dry-run=client \
--from-literal=user="tiger_memory" \
--from-literal=password="secret" \
--from-literal=database="tsdb" \
--from-literal=host="x.y.tsdb.cloud.timescale.com" \
--from-literal=port="32467" \
-o yaml | kubeseal -o yaml
# https://logfire-us.pydantic.dev/tigerdata/tigerdata/settings/write-tokens
kubectl -n savannah-system create secret generic tiger-memory-mcp-server-logfire \
--dry-run=client \
--from-literal=token="pylf_v1_us_" \
-o yaml | kubeseal -o yaml
# https://login.tailscale.com/admin/settings/keys
kubectl -n savannah-system create secret generic tiger-memory-mcp-server-tailscale \
--dry-run=client \
--from-literal=authkey="tskey-auth-" \
-o yaml | kubeseal -o yaml
```
Update `./chart/values/dev.yaml` with the output.