Update doc

Author: synw

docsite/public/doc/1.get_started/1.install.md

@@ -7,5 +7,6 @@ pip install django-mqueue
 Add to `INSTALLED_APPS`:
 
 ```
+"import_export",
 "mqueue",
 ```

docsite/public/doc/6.mcp/1.mcp_server.md

@@ -0,0 +1,146 @@
+# Model context protocol server
+
+A Mcp server is available to access events.
+
+## Install
+
+To use the Mcp server in your app install [Django Mcpx](https://github.com/synw/django-mcpx) and
+add it to INSTALLED_APPS in settings:
+
+```bash
+pip install django-mcpx
+```
+
+```python settings.py
+INSTALLED_APPS = [
+    "mqueue",
+    'mcpx',
+]
+```
+
+Declare the Mcp server and an auth token in settings:
+
+```python settings.py
+MCP_SERVERS = ["mqueue.mcpserver.mcp_server"]
+
+MCP_AUTH = "fefe865fe4856ferqsijjfhe-fre5qxpokjnEEZ5" # your auth token
+MCP_PORT = 8397 # optional
+MCP_HOST = "localhost" # optional
+```
+
+## Run
+
+```bash
+python manage.py runmcp --host localhost --port 8397
+```
+
+This will start the MCP servers on `localhost` at port `8397`.
+
+Test it with a client or Mcp inspector:
+
+```json
+{
+    "My Mcp server": {
+      "command": "npx",
+      "args": [
+        "mcp-remote",
+        "http://localhost:8397/mcp",
+        "--header",
+        "Authorization: Bearer fefe865fe4856ferqsijjfhe-fre5qxpokjnEEZ5"
+      ]
+    }
+}
+```
+
+## Tools
+
+The Mcp server provides the following tools to interact with events:
+
+### query_events_since
+
+**Description:** Query for events in the database since a given date.
+
+**Parameters:**
+- `start_date` (str): The start date for the query (use a standard Python date string).
+
+**Example Usage:**
+```json
+{
+  "command": "query_events_since",
+  "args": {
+    "start_date": "2023-10-01"
+  }
+}
+```
+
+### query_events
+
+**Description:** Query for events in the database.
+
+**Parameters:**
+- `nevents` (int): Maximum number of events to retrieve.
+
+**Example Usage:**
+```json
+{
+  "command": "query_events",
+  "args": {
+    "nevents": 10
+  }
+}
+```
+
+## Customizing Queries
+
+You can customize the queries by creating your own custom MCP server file. Below is an example of how you can achieve this by limiting the queries to events in a specific bucket.
+
+### Example: Limiting Queries to a Specific Bucket
+
+Create a new Python file, for example, `my_app.mcpserver.py`, and add the following code:
+
+```py custom_mcpserver.py
+from typing import Any, Dict
+from fastmcp import FastMCP
+from pydantic import Field
+from django.core.exceptions import PermissionDenied
+from mcpx.auth import mcp_auth
+from mqueue.models import MEvent
+from mqueue.utils import formatEvent, validate_and_parse_date
+
+name = "Custom Mcp events Server"
+mcp = FastMCP(name=name)
+
+@mcp.tool()
+async def query_events_in_bucket(
+    start_date: str = Field(description="The start date for the query (use a standard Python date string)"),
+    bucket: str = Field(description="The value of the bucket to filter events by")
+) -> Dict[str, Any]:
+    """Query for events in the database since a given date within a specific bucket"""
+    try:
+        mcp_auth()
+    except PermissionDenied as e:
+        print(f"Mcp authentication error: {e}")
+        return {"error": "undefined"}
+    parsed_date = validate_and_parse_date(start_date)
+    results = []
+    async for row in MEvent.objects.select_related("user").filter(
+        date_posted__date__gte=parsed_date,
+        bucket=bucket
+    ):
+        results.append(formatEvent(row))
+    return {"result": results}
+
+mcp_server = {
+    "name": name,
+    "mcp": mcp,
+}
+```
+
+Add your new custom MCP server to the `MCP_SERVERS` list in your Django settings file.
+
+```python settings.py
+MCP_SERVERS = [
+    "my_app.mcpserver.mcp_server",
+]
+```
+