pocket-notes 0.1.0__py3-none-any.whl

pocket_notes/__init__.py

@@ -0,0 +1 @@
+

pocket_notes/server.py

@@ -0,0 +1,59 @@
+from contextlib import closing
+from pathlib import Path
+import sqlite3
+
+from fastmcp import FastMCP
+
+mcp = FastMCP("Pocket Notes")
+DB_PATH = Path.home() / ".pocket-notes" / "notes.db"
+
+
+@mcp.tool
+def greet(name: str) -> str:
+    return f"Hello, {name}!"
+
+
+@mcp.tool
+def save_note(content: str) -> dict:
+    """save this note to local for further use"""
+    content = content.strip()
+    if not content:
+        raise ValueError("Note can't be empty!")
+
+    DB_PATH.parent.mkdir(parents=True, exist_ok=True)
+
+    with closing(sqlite3.connect(DB_PATH)) as conn:
+        conn.execute(
+            "CREATE TABLE IF NOT EXISTS notes "
+            "(id INTEGER PRIMARY KEY, content TEXT NOT NULL)"
+        )
+        cursor = conn.execute(
+            "INSERT INTO notes (content) VALUES (?)", (content,)
+        )
+        conn.commit()
+        return {"id": cursor.lastrowid, "content": content}
+
+
+@mcp.tool
+def search_notes(keyword: str) -> list[dict]:
+    """Use keywords to search local notes, return up to the most recent 20 notes"""
+    keyword = keyword.strip()
+    if not keyword:
+        raise ValueError("Search keyword can't be empty!")
+
+    if not DB_PATH.exists():
+        return []
+
+    with closing(sqlite3.connect(DB_PATH)) as conn:
+        conn.row_factory = sqlite3.Row
+        rows = conn.execute(
+            "SELECT id, content FROM notes "
+            "WHERE content LIKE ? "
+            "ORDER BY id DESC LIMIT 20",
+            (f"%{keyword}%",),
+        ).fetchall()
+        return [dict(row) for row in rows]
+
+
+def main() -> None:
+    mcp.run(transport="stdio")

pocket_notes-0.1.0.dist-info/METADATA

@@ -0,0 +1,48 @@
+Metadata-Version: 2.3
+Name: pocket-notes
+Version: 0.1.0
+Summary: A local notes MCP server for Claude and Codex.
+Author: Chen Ting
+Author-email: Chen Ting <c.tingkuo216@gmail.com>
+Requires-Dist: fastmcp>=4.1.3
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# Pocket Notes
+
+A simple local note-taking MCP server built with Python and FastMCP.
+Save and search notes through an MCP-compatible client.
+
+## Tools
+
+- `save_note(content)`: Save a note to the local database.
+- `search_notes(keyword)`: Search notes by keyword and return up to the 20 most recent matches.
+- `greet(name)`: Return a greeting to test the connection.
+
+## Requirements
+
+- Python 3.12 or later
+- [uv](https://docs.astral.sh/uv/getting-started/installation/)
+- Codex CLI for the setup below
+
+## Connect to Codex
+
+Register the MCP server:
+
+```bash
+codex mcp add pocket-notes -- uvx pocket-notes
+```
+
+Start a new Codex session to use the tools.
+
+## Data Storage
+
+Notes are stored in a local SQLite database:
+
+```text
+~/.pocket-notes/notes.db
+```
+
+Here, `~` refers to your home directory.
+
+MCP clients running under the same user account on the same computer can share this database.

pocket_notes-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+pocket_notes/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+pocket_notes/server.py,sha256=RTNlc5-WUklP4_M6y7Z8xddatJnczSVwsMzB4vpODdo,1580
+pocket_notes-0.1.0.dist-info/WHEEL,sha256=l3MmIxu8qaet7ng2J9fFoJnYGj8IREj7jXTbgsuzmy4,81
+pocket_notes-0.1.0.dist-info/entry_points.txt,sha256=r_xjJw4hbiWAbTKe5DjSCbRyGmOCAtnoZBO4HJm1S9o,59
+pocket_notes-0.1.0.dist-info/METADATA,sha256=TsCdtuS9jDuG8kW68UGEb1dnf9Qz-GybHp1-E7A_ol0,1166
+pocket_notes-0.1.0.dist-info/RECORD,,

pocket_notes-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.11.32
+Root-Is-Purelib: true
+Tag: py3-none-any

pocket_notes-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+pocket-notes = pocket_notes.server:main
+