pocket-notes 0.1.0__tar.gz

pocket_notes-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,38 @@
+# 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/pyproject.toml

@@ -0,0 +1,19 @@
+[project]
+name = "pocket-notes"
+version = "0.1.0"
+description = "A local notes MCP server for Claude and Codex."
+readme = "README.md"
+authors = [
+    { name = "Chen Ting", email = "c.tingkuo216@gmail.com" }
+]
+requires-python = ">=3.12"
+dependencies = [
+    "fastmcp>=4.1.3",
+]
+
+[project.scripts]
+pocket-notes = "pocket_notes.server:main"
+
+[build-system]
+requires = ["uv_build>=0.11.32,<0.12.0"]
+build-backend = "uv_build"

pocket_notes-0.1.0/src/pocket_notes/__init__.py

@@ -0,0 +1 @@
+

pocket_notes-0.1.0/src/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")