feat: Gruppe 1 – Projektgerüst, Auth, CLI (v0.1.0)
- pyproject.toml: hatchling build, mcp-familywall entry-point, deps - src/mcp_familywall/__init__.py: version 0.1.0 - src/mcp_familywall/config.py: YAML config loader (schema_version: 1) - src/mcp_familywall/auth.py: keyring credential resolution (FW_EMAIL/FW_PASSWORD → keyring) - src/mcp_familywall/fw_client.py: httpx client, login/logout/call, FW_DEBUG logging - src/mcp_familywall/cli.py: click CLI with setup / check / serve commands - .gitignore, README.md, CLAUDE.md, SPEC.md Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,75 @@
|
||||
# mcp-familywall
|
||||
|
||||
MCP server for [Family Wall](https://www.familywall.com) -- read your family's circles, lists, and tasks directly from Claude.
|
||||
|
||||
## Features (v1.0 -- read-only)
|
||||
|
||||
- `get_circles` -- list all family circles
|
||||
- `get_lists` -- list all task lists (optionally filtered by circle)
|
||||
- `get_tasks` -- list tasks in a specific list
|
||||
|
||||
## Requirements
|
||||
|
||||
- Python 3.12+
|
||||
- [uv](https://docs.astral.sh/uv/)
|
||||
- A Family Wall account
|
||||
|
||||
## Installation
|
||||
|
||||
```bash
|
||||
uv tool install mcp-familywall
|
||||
```
|
||||
|
||||
## Setup
|
||||
|
||||
Run the interactive setup wizard once to store your credentials securely in the OS keyring:
|
||||
|
||||
```bash
|
||||
mcp-familywall setup
|
||||
```
|
||||
|
||||
This will:
|
||||
1. Prompt for your Family Wall email and password
|
||||
2. Verify the credentials against the API
|
||||
3. Store them in the OS keyring
|
||||
4. Print a Claude Desktop configuration snippet
|
||||
|
||||
## Claude Desktop configuration
|
||||
|
||||
Add the printed snippet to your `claude_desktop_config.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"familywall": {
|
||||
"command": "uvx",
|
||||
"args": ["mcp-familywall", "serve"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Verify
|
||||
|
||||
```bash
|
||||
mcp-familywall check
|
||||
```
|
||||
|
||||
## Debug logging
|
||||
|
||||
Set `FW_DEBUG=1` to log full request/response bodies to stderr (passwords are masked):
|
||||
|
||||
```bash
|
||||
FW_DEBUG=1 mcp-familywall check
|
||||
```
|
||||
|
||||
## Credentials
|
||||
|
||||
Credentials are resolved in this order:
|
||||
|
||||
1. Environment variables `FW_EMAIL` and `FW_PASSWORD`
|
||||
2. OS keyring (set by `mcp-familywall setup`)
|
||||
|
||||
## License
|
||||
|
||||
MIT
|
||||
|
||||
Reference in New Issue
Block a user