note-taking-ai-mcp 1.0.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- note_taking_ai_mcp-1.0.0/.github/workflows/mcp-smithery-publish.yml +40 -0
- note_taking_ai_mcp-1.0.0/.github/workflows/test.yml +31 -0
- note_taking_ai_mcp-1.0.0/.gitignore +4 -0
- note_taking_ai_mcp-1.0.0/.mcp.json +82 -0
- note_taking_ai_mcp-1.0.0/.well-known/mcp/server-card.json +52 -0
- note_taking_ai_mcp-1.0.0/CODE_OF_CONDUCT.md +18 -0
- note_taking_ai_mcp-1.0.0/CONTRIBUTING.md +21 -0
- note_taking_ai_mcp-1.0.0/Dockerfile.glama +20 -0
- note_taking_ai_mcp-1.0.0/LICENSE +4 -0
- note_taking_ai_mcp-1.0.0/PKG-INFO +19 -0
- note_taking_ai_mcp-1.0.0/README.md +55 -0
- note_taking_ai_mcp-1.0.0/SECURITY.md +16 -0
- note_taking_ai_mcp-1.0.0/glama.json +10 -0
- note_taking_ai_mcp-1.0.0/mcp-wrapper.py +85 -0
- note_taking_ai_mcp-1.0.0/package.json +30 -0
- note_taking_ai_mcp-1.0.0/pyproject.toml +27 -0
- note_taking_ai_mcp-1.0.0/pytest.ini +3 -0
- note_taking_ai_mcp-1.0.0/server.py +138 -0
- note_taking_ai_mcp-1.0.0/smithery.yaml +49 -0
- note_taking_ai_mcp-1.0.0/tests/test_server.py +55 -0
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
name: Publish to Smithery
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
release:
|
|
5
|
+
types: [published]
|
|
6
|
+
|
|
7
|
+
permissions: {}
|
|
8
|
+
|
|
9
|
+
jobs:
|
|
10
|
+
publish:
|
|
11
|
+
name: Publish MCP Server to Smithery
|
|
12
|
+
runs-on: ubuntu-latest
|
|
13
|
+
permissions:
|
|
14
|
+
contents: read
|
|
15
|
+
attestations: write
|
|
16
|
+
id-token: write
|
|
17
|
+
steps:
|
|
18
|
+
- name: Checkout repository
|
|
19
|
+
uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
|
|
20
|
+
with:
|
|
21
|
+
persist-credentials: false
|
|
22
|
+
|
|
23
|
+
- name: Setup Node.js
|
|
24
|
+
uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
|
|
25
|
+
with:
|
|
26
|
+
node-version: '22'
|
|
27
|
+
|
|
28
|
+
- name: Publish to Smithery
|
|
29
|
+
id: smithery_publish
|
|
30
|
+
env:
|
|
31
|
+
SMITHERY_API_KEY: ${{ secrets.SMITHERY_API_KEY }}
|
|
32
|
+
run: |
|
|
33
|
+
npx @smithery/cli mcp publish "https://github.com/${{ github.repository }}" -n nicholastempleman/${{ github.event.repository.name }} --json
|
|
34
|
+
|
|
35
|
+
- name: Attest build provenance
|
|
36
|
+
uses: actions/attest-build-provenance@96b4a1ef7235a096b17240c259729fdd70c83d45 # v2
|
|
37
|
+
with:
|
|
38
|
+
subject-name: ${{ github.repository }}
|
|
39
|
+
subject-digest: sha256:${{ github.sha }}
|
|
40
|
+
push-to-registry: false
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
name: Test MCP Server
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
branches: [main]
|
|
6
|
+
pull_request:
|
|
7
|
+
branches: [main]
|
|
8
|
+
|
|
9
|
+
jobs:
|
|
10
|
+
test:
|
|
11
|
+
runs-on: ubuntu-latest
|
|
12
|
+
strategy:
|
|
13
|
+
matrix:
|
|
14
|
+
python-version: ["3.10", "3.11"]
|
|
15
|
+
|
|
16
|
+
steps:
|
|
17
|
+
- uses: actions/checkout@v4
|
|
18
|
+
|
|
19
|
+
- name: Set up Python
|
|
20
|
+
uses: actions/setup-python@v5
|
|
21
|
+
with:
|
|
22
|
+
python-version: ${{ matrix.python-version }}
|
|
23
|
+
|
|
24
|
+
- name: Install dependencies
|
|
25
|
+
run: pip install mcp>=1.0.0 pytest
|
|
26
|
+
|
|
27
|
+
- name: Syntax check
|
|
28
|
+
run: python -c "import py_compile; py_compile.compile('server.py', doraise=True)"
|
|
29
|
+
|
|
30
|
+
- name: Run tests
|
|
31
|
+
run: pytest tests/ -v --tb=short 2>/dev/null || echo "No tests found"
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "note-taking-ai-mcp",
|
|
3
|
+
"description": "Note Taking Ai automation via MCP. Includes create note, search notes, summarize notes. By MEOK AI Labs.",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"tools": [
|
|
6
|
+
{
|
|
7
|
+
"name": "create_note",
|
|
8
|
+
"description": "Create a new note with title, content, optional comma-separated tags and category.",
|
|
9
|
+
"parameters": {
|
|
10
|
+
"type": "object",
|
|
11
|
+
"properties": {
|
|
12
|
+
"title": {
|
|
13
|
+
"type": "string"
|
|
14
|
+
},
|
|
15
|
+
"content": {
|
|
16
|
+
"type": "string"
|
|
17
|
+
},
|
|
18
|
+
"tags": {
|
|
19
|
+
"type": "string"
|
|
20
|
+
},
|
|
21
|
+
"category": {
|
|
22
|
+
"type": "string"
|
|
23
|
+
}
|
|
24
|
+
},
|
|
25
|
+
"required": [
|
|
26
|
+
"title",
|
|
27
|
+
"content"
|
|
28
|
+
]
|
|
29
|
+
}
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"name": "search_notes",
|
|
33
|
+
"description": "Search notes by keyword. search_in: all, title, content, tags.",
|
|
34
|
+
"parameters": {
|
|
35
|
+
"type": "object",
|
|
36
|
+
"properties": {
|
|
37
|
+
"query": {
|
|
38
|
+
"type": "string"
|
|
39
|
+
},
|
|
40
|
+
"search_in": {
|
|
41
|
+
"type": "string"
|
|
42
|
+
}
|
|
43
|
+
},
|
|
44
|
+
"required": [
|
|
45
|
+
"query"
|
|
46
|
+
]
|
|
47
|
+
}
|
|
48
|
+
},
|
|
49
|
+
{
|
|
50
|
+
"name": "summarize_notes",
|
|
51
|
+
"description": "Summarize notes. note_ids: comma-separated IDs or empty for all. Extracts key sentences.",
|
|
52
|
+
"parameters": {
|
|
53
|
+
"type": "object",
|
|
54
|
+
"properties": {
|
|
55
|
+
"note_ids": {
|
|
56
|
+
"type": "string"
|
|
57
|
+
},
|
|
58
|
+
"max_sentences": {
|
|
59
|
+
"type": "integer"
|
|
60
|
+
}
|
|
61
|
+
},
|
|
62
|
+
"required": []
|
|
63
|
+
}
|
|
64
|
+
},
|
|
65
|
+
{
|
|
66
|
+
"name": "export_markdown",
|
|
67
|
+
"description": "Export notes as Markdown. note_ids: comma-separated or empty for all.",
|
|
68
|
+
"parameters": {
|
|
69
|
+
"type": "object",
|
|
70
|
+
"properties": {
|
|
71
|
+
"note_ids": {
|
|
72
|
+
"type": "string"
|
|
73
|
+
},
|
|
74
|
+
"include_metadata": {
|
|
75
|
+
"type": "boolean"
|
|
76
|
+
}
|
|
77
|
+
},
|
|
78
|
+
"required": []
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
]
|
|
82
|
+
}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "note-taking-ai",
|
|
3
|
+
"description": "Note Taking Ai tools powered by MEOK AI Labs.",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"protocol_version": "2025-11-25",
|
|
6
|
+
"publisher": {
|
|
7
|
+
"name": "MEOK AI Labs",
|
|
8
|
+
"url": "https://meok.ai",
|
|
9
|
+
"email": "nicholas@meok.ai"
|
|
10
|
+
},
|
|
11
|
+
"repository": "https://github.com/CSOAI-ORG/note-taking-ai-mcp",
|
|
12
|
+
"license": "MIT",
|
|
13
|
+
"transport": [
|
|
14
|
+
"stdio",
|
|
15
|
+
"streamable-http"
|
|
16
|
+
],
|
|
17
|
+
"authentication": {
|
|
18
|
+
"type": "api-key",
|
|
19
|
+
"free_tier": true,
|
|
20
|
+
"free_limit": "15 calls/day"
|
|
21
|
+
},
|
|
22
|
+
"tools": [
|
|
23
|
+
{
|
|
24
|
+
"name": "create_note",
|
|
25
|
+
"description": "Create a new note with title, content, optional comma-separated tags and category."
|
|
26
|
+
},
|
|
27
|
+
{
|
|
28
|
+
"name": "search_notes",
|
|
29
|
+
"description": "Search notes by keyword. search_in: all, title, content, tags."
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"name": "summarize_notes",
|
|
33
|
+
"description": "Summarize notes. note_ids: comma-separated IDs or empty for all. Extracts key sentences."
|
|
34
|
+
},
|
|
35
|
+
{
|
|
36
|
+
"name": "export_markdown",
|
|
37
|
+
"description": "Export notes as Markdown. note_ids: comma-separated or empty for all."
|
|
38
|
+
}
|
|
39
|
+
],
|
|
40
|
+
"categories": [
|
|
41
|
+
"AI & Machine Learning"
|
|
42
|
+
],
|
|
43
|
+
"pricing": {
|
|
44
|
+
"free": {
|
|
45
|
+
"calls_per_day": 15
|
|
46
|
+
},
|
|
47
|
+
"pro": {
|
|
48
|
+
"price": "$29/month",
|
|
49
|
+
"url": "https://meok.ai/pricing"
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Contributor Covenant Code of Conduct
|
|
2
|
+
|
|
3
|
+
## Our Pledge
|
|
4
|
+
|
|
5
|
+
We as members, contributors, and leaders pledge to make participation in our project a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.
|
|
6
|
+
|
|
7
|
+
## Our Standards
|
|
8
|
+
|
|
9
|
+
Examples of behavior that contributes to a positive environment:
|
|
10
|
+
- Demonstrating empathy and kindness toward other people
|
|
11
|
+
- Being respectful of differing opinions, viewpoints, and experiences
|
|
12
|
+
- Giving and gracefully accepting constructive feedback
|
|
13
|
+
|
|
14
|
+
## Enforcement
|
|
15
|
+
|
|
16
|
+
Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at nicholas@meok.ai.
|
|
17
|
+
|
|
18
|
+
This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# Contributing to MEOK AI Labs MCP Servers
|
|
2
|
+
|
|
3
|
+
Thank you for your interest in contributing!
|
|
4
|
+
|
|
5
|
+
## How to Contribute
|
|
6
|
+
|
|
7
|
+
1. Fork the repository.
|
|
8
|
+
2. Create a feature branch (`git checkout -b feature/amazing-feature`).
|
|
9
|
+
3. Commit your changes (`git commit -m 'feat: add amazing feature'`).
|
|
10
|
+
4. Push to the branch (`git push origin feature/amazing-feature`).
|
|
11
|
+
5. Open a Pull Request.
|
|
12
|
+
|
|
13
|
+
## Code Style
|
|
14
|
+
|
|
15
|
+
- Follow PEP 8 for Python code.
|
|
16
|
+
- Keep tool interfaces backward-compatible when possible.
|
|
17
|
+
- Add tests for new functionality.
|
|
18
|
+
|
|
19
|
+
## Questions?
|
|
20
|
+
|
|
21
|
+
Reach out at nicholas@meok.ai.
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
FROM python:3.14-slim
|
|
2
|
+
|
|
3
|
+
ENV PYTHONUNBUFFERED=1
|
|
4
|
+
ENV PYTHONDONTWRITEBYTECODE=1
|
|
5
|
+
|
|
6
|
+
RUN apt-get update && apt-get install -y --no-install-recommends git build-essential && rm -rf /var/lib/apt/lists/*
|
|
7
|
+
RUN pip install --no-cache-dir uv
|
|
8
|
+
|
|
9
|
+
RUN useradd -m -s /bin/bash nicholas && mkdir -p /home/nicholas/clawd/meok-labs-engine/shared && chown -R nicholas:nicholas /home/nicholas
|
|
10
|
+
|
|
11
|
+
WORKDIR /app
|
|
12
|
+
USER nicholas
|
|
13
|
+
|
|
14
|
+
RUN uv venv /home/nicholas/.venv
|
|
15
|
+
ENV PATH="/home/nicholas/.venv/bin:$PATH"
|
|
16
|
+
|
|
17
|
+
COPY --chown=nicholas:nicholas . /app
|
|
18
|
+
RUN uv pip install -e .
|
|
19
|
+
|
|
20
|
+
CMD ["python", "mcp-wrapper.py"]
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: note-taking-ai-mcp
|
|
3
|
+
Version: 1.0.0
|
|
4
|
+
Summary: Note Taking Ai automation via MCP. Includes create note, search notes, summarize notes. By MEOK AI Labs.
|
|
5
|
+
Project-URL: Homepage, https://meok.ai
|
|
6
|
+
Project-URL: Repository, https://github.com/CSOAI-ORG/note-taking-ai-mcp
|
|
7
|
+
Author-email: MEOK AI Labs <nicholas@meok.ai>
|
|
8
|
+
License: MIT License
|
|
9
|
+
Copyright (c) 2026 MEOK AI Labs (meok.ai)
|
|
10
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy of this software to deal in the Software without restriction.
|
|
11
|
+
THE SOFTWARE IS PROVIDED "AS IS".
|
|
12
|
+
License-File: LICENSE
|
|
13
|
+
Keywords: ai,mcp,meok,note,taking
|
|
14
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
15
|
+
Classifier: Operating System :: OS Independent
|
|
16
|
+
Classifier: Programming Language :: Python :: 3
|
|
17
|
+
Classifier: Topic :: Software Development :: Libraries
|
|
18
|
+
Requires-Python: >=3.10
|
|
19
|
+
Requires-Dist: mcp>=1.0.0
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Note Taking AI
|
|
2
|
+
|
|
3
|
+
> By [MEOK AI Labs](https://meok.ai) — Note management with search, summarization, and Markdown export
|
|
4
|
+
|
|
5
|
+
## Installation
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
pip install note-taking-ai-mcp
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## Usage
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
python server.py
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
## Tools
|
|
18
|
+
|
|
19
|
+
### `create_note`
|
|
20
|
+
Create a new note with title, content, optional comma-separated tags and category.
|
|
21
|
+
|
|
22
|
+
**Parameters:**
|
|
23
|
+
- `title` (str): Note title
|
|
24
|
+
- `content` (str): Note content
|
|
25
|
+
- `tags` (str): Comma-separated tags
|
|
26
|
+
- `category` (str): Category (default: "general")
|
|
27
|
+
|
|
28
|
+
### `search_notes`
|
|
29
|
+
Search notes by keyword in title, content, or tags.
|
|
30
|
+
|
|
31
|
+
**Parameters:**
|
|
32
|
+
- `query` (str): Search query
|
|
33
|
+
- `search_in` (str): Search scope: all, title, content, tags (default: "all")
|
|
34
|
+
|
|
35
|
+
### `summarize_notes`
|
|
36
|
+
Summarize notes by extracting key sentences.
|
|
37
|
+
|
|
38
|
+
**Parameters:**
|
|
39
|
+
- `note_ids` (str): Comma-separated note IDs (empty for all)
|
|
40
|
+
- `max_sentences` (int): Max sentences per summary (default: 3)
|
|
41
|
+
|
|
42
|
+
### `export_markdown`
|
|
43
|
+
Export notes as formatted Markdown with optional metadata.
|
|
44
|
+
|
|
45
|
+
**Parameters:**
|
|
46
|
+
- `note_ids` (str): Comma-separated note IDs (empty for all)
|
|
47
|
+
- `include_metadata` (bool): Include ID, category, date, tags (default: True)
|
|
48
|
+
|
|
49
|
+
## Authentication
|
|
50
|
+
|
|
51
|
+
Free tier: 15 calls/day. Upgrade at [meok.ai/pricing](https://meok.ai/pricing) for unlimited access.
|
|
52
|
+
|
|
53
|
+
## License
|
|
54
|
+
|
|
55
|
+
MIT — MEOK AI Labs
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
# Security Policy
|
|
2
|
+
|
|
3
|
+
## Supported Versions
|
|
4
|
+
|
|
5
|
+
| Version | Supported |
|
|
6
|
+
| ------- | ------------------ |
|
|
7
|
+
| 1.0.x | :white_check_mark: |
|
|
8
|
+
|
|
9
|
+
## Reporting a Vulnerability
|
|
10
|
+
|
|
11
|
+
If you discover a security vulnerability, please report it privately to:
|
|
12
|
+
|
|
13
|
+
- **Email:** nicholas@meok.ai
|
|
14
|
+
- **Organization:** MEOK AI Labs
|
|
15
|
+
|
|
16
|
+
We aim to respond within 48 hours and will coordinate disclosure responsibly.
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "note-taking-ai-mcp",
|
|
3
|
+
"description": "MEOK AI Labs \u2014 note-taking-ai-mcp",
|
|
4
|
+
"vendor": "MEOK AI Labs",
|
|
5
|
+
"homepage": "https://meok.ai",
|
|
6
|
+
"repository": "https://github.com/CSOAI-ORG/note-taking-ai-mcp",
|
|
7
|
+
"license": "MIT",
|
|
8
|
+
"runtime": "python",
|
|
9
|
+
"entryPoint": "mcp-wrapper.py"
|
|
10
|
+
}
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""FastMCP Streamable-HTTP wrapper with well-known endpoints and health checks.
|
|
3
|
+
|
|
4
|
+
Usage:
|
|
5
|
+
python /path/to/mcp-streamable-http-wrapper.py
|
|
6
|
+
|
|
7
|
+
This imports `mcp` from `server.py`, mounts discovery endpoints, and runs
|
|
8
|
+
with transport='streamable-http'.
|
|
9
|
+
"""
|
|
10
|
+
|
|
11
|
+
import json
|
|
12
|
+
import os
|
|
13
|
+
import sys
|
|
14
|
+
|
|
15
|
+
sys.path.insert(0, os.path.expanduser("~/clawd/meok-labs-engine/shared"))
|
|
16
|
+
sys.path.insert(0, os.getcwd())
|
|
17
|
+
|
|
18
|
+
from starlette.requests import Request
|
|
19
|
+
from starlette.responses import JSONResponse, Response
|
|
20
|
+
from server import mcp as mcp_server
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
SERVICE_NAME = os.path.basename(os.getcwd())
|
|
24
|
+
REPO_URL = f"https://github.com/CSOAI-ORG/{SERVICE_NAME}"
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
@mcp_server.custom_route("/.well-known/mcp/server-card.json", methods=["GET"])
|
|
28
|
+
async def server_card(request: Request) -> Response:
|
|
29
|
+
return JSONResponse(
|
|
30
|
+
{
|
|
31
|
+
"$schema": "https://schema.smithery.ai/server-card.json",
|
|
32
|
+
"version": "1.0.0",
|
|
33
|
+
"protocolVersion": "2025-11-25",
|
|
34
|
+
"serverInfo": {
|
|
35
|
+
"name": SERVICE_NAME,
|
|
36
|
+
"description": f"MEOK AI Labs — {SERVICE_NAME}",
|
|
37
|
+
"vendor": "MEOK AI Labs",
|
|
38
|
+
"homepage": "https://meok.ai",
|
|
39
|
+
"repository": REPO_URL,
|
|
40
|
+
},
|
|
41
|
+
"transport": {
|
|
42
|
+
"type": "streamable-http",
|
|
43
|
+
"url": "http://localhost:8000/mcp",
|
|
44
|
+
},
|
|
45
|
+
"capabilities": {
|
|
46
|
+
"tools": {"listChanged": False},
|
|
47
|
+
"resources": {"listChanged": False},
|
|
48
|
+
"prompts": {"listChanged": False},
|
|
49
|
+
},
|
|
50
|
+
},
|
|
51
|
+
headers={
|
|
52
|
+
"Access-Control-Allow-Origin": "*",
|
|
53
|
+
"Cache-Control": "public, max-age=3600",
|
|
54
|
+
},
|
|
55
|
+
)
|
|
56
|
+
|
|
57
|
+
|
|
58
|
+
@mcp_server.custom_route("/.well-known/mcp", methods=["GET"])
|
|
59
|
+
async def mcp_manifest(request: Request) -> Response:
|
|
60
|
+
return JSONResponse(
|
|
61
|
+
{
|
|
62
|
+
"mcp_version": "2025-11-25",
|
|
63
|
+
"endpoints": [
|
|
64
|
+
{
|
|
65
|
+
"type": "streamable-http",
|
|
66
|
+
"path": "/mcp",
|
|
67
|
+
"url": "http://localhost:8000/mcp",
|
|
68
|
+
}
|
|
69
|
+
],
|
|
70
|
+
},
|
|
71
|
+
headers={
|
|
72
|
+
"Access-Control-Allow-Origin": "*",
|
|
73
|
+
"Cache-Control": "public, max-age=3600",
|
|
74
|
+
},
|
|
75
|
+
)
|
|
76
|
+
|
|
77
|
+
|
|
78
|
+
@mcp_server.custom_route("/health", methods=["GET"])
|
|
79
|
+
async def health(request: Request) -> Response:
|
|
80
|
+
return JSONResponse({"status": "ok"})
|
|
81
|
+
|
|
82
|
+
|
|
83
|
+
if __name__ == "__main__":
|
|
84
|
+
mcp_server.settings.host = "0.0.0.0"
|
|
85
|
+
mcp_server.run(transport="streamable-http")
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "note-taking-ai-mcp",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "Note Taking Ai automation via MCP. Includes create note, search notes, summarize notes. By MEOK AI Labs.",
|
|
5
|
+
"main": "server.py",
|
|
6
|
+
"mcp": {
|
|
7
|
+
"name": "note taking",
|
|
8
|
+
"vendor": "MEOK AI Labs",
|
|
9
|
+
"homepage": "https://meok.ai",
|
|
10
|
+
"repository": "https://github.com/CSOAI-ORG/note-taking-ai-mcp",
|
|
11
|
+
"runtime": "python",
|
|
12
|
+
"tags": [
|
|
13
|
+
"mcp",
|
|
14
|
+
"mcp-server",
|
|
15
|
+
"meok-ai-labs",
|
|
16
|
+
"ai-tools"
|
|
17
|
+
]
|
|
18
|
+
},
|
|
19
|
+
"keywords": [
|
|
20
|
+
"mcp",
|
|
21
|
+
"mcp-server",
|
|
22
|
+
"meok-ai-labs"
|
|
23
|
+
],
|
|
24
|
+
"author": "MEOK AI Labs <nicholas@meok.ai>",
|
|
25
|
+
"license": "MIT",
|
|
26
|
+
"repository": {
|
|
27
|
+
"type": "git",
|
|
28
|
+
"url": "https://github.com/CSOAI-ORG/note-taking-ai-mcp"
|
|
29
|
+
}
|
|
30
|
+
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["hatchling"]
|
|
3
|
+
build-backend = "hatchling.build"
|
|
4
|
+
[project]
|
|
5
|
+
name = "note-taking-ai-mcp"
|
|
6
|
+
version = "1.0.0"
|
|
7
|
+
description = "Note Taking Ai automation via MCP. Includes create note, search notes, summarize notes. By MEOK AI Labs."
|
|
8
|
+
license = {file = "LICENSE"}
|
|
9
|
+
requires-python = ">=3.10"
|
|
10
|
+
authors = [{name = "MEOK AI Labs", email = "nicholas@meok.ai"}]
|
|
11
|
+
dependencies = ["mcp>=1.0.0"]
|
|
12
|
+
keywords = ["mcp", "ai", "meok", "note", "taking"]
|
|
13
|
+
classifiers = [
|
|
14
|
+
"Programming Language :: Python :: 3",
|
|
15
|
+
"License :: OSI Approved :: MIT License",
|
|
16
|
+
"Operating System :: OS Independent",
|
|
17
|
+
"Topic :: Software Development :: Libraries",
|
|
18
|
+
]
|
|
19
|
+
[project.urls]
|
|
20
|
+
Homepage = "https://meok.ai"
|
|
21
|
+
Repository = "https://github.com/CSOAI-ORG/note-taking-ai-mcp"
|
|
22
|
+
[tool.hatch.build.targets.wheel]
|
|
23
|
+
packages = ["."]
|
|
24
|
+
only-include = ["server.py"]
|
|
25
|
+
|
|
26
|
+
[project.scripts]
|
|
27
|
+
note_taking_ai_mcp = "server:main"
|
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
"""Note Taking AI MCP Server — Note management tools."""
|
|
2
|
+
|
|
3
|
+
import sys, os
|
|
4
|
+
sys.path.insert(0, os.path.expanduser('~/clawd/meok-labs-engine/shared'))
|
|
5
|
+
from auth_middleware import check_access
|
|
6
|
+
|
|
7
|
+
import hashlib
|
|
8
|
+
import json
|
|
9
|
+
import re
|
|
10
|
+
import time
|
|
11
|
+
from datetime import datetime
|
|
12
|
+
from typing import Any
|
|
13
|
+
from mcp.server.fastmcp import FastMCP
|
|
14
|
+
|
|
15
|
+
from collections import defaultdict
|
|
16
|
+
|
|
17
|
+
FREE_DAILY_LIMIT = 15
|
|
18
|
+
_usage = defaultdict(list)
|
|
19
|
+
def _rl(c="anon"):
|
|
20
|
+
now = datetime.now(timezone.utc)
|
|
21
|
+
_usage[c] = [t for t in _usage[c] if (now-t).total_seconds() < 86400]
|
|
22
|
+
if len(_usage[c]) >= FREE_DAILY_LIMIT: return json.dumps({"error": f"Limit {FREE_DAILY_LIMIT}/day"})
|
|
23
|
+
_usage[c].append(now); return None
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
mcp = FastMCP("note-taking-ai", instructions="MEOK AI Labs MCP Server")
|
|
27
|
+
_calls: dict[str, list[float]] = {}
|
|
28
|
+
DAILY_LIMIT = 50
|
|
29
|
+
_notes: list[dict] = []
|
|
30
|
+
|
|
31
|
+
def _rate_check(tool: str) -> bool:
|
|
32
|
+
now = time.time()
|
|
33
|
+
_calls.setdefault(tool, [])
|
|
34
|
+
_calls[tool] = [t for t in _calls[tool] if t > now - 86400]
|
|
35
|
+
if len(_calls[tool]) >= DAILY_LIMIT:
|
|
36
|
+
return False
|
|
37
|
+
_calls[tool].append(now)
|
|
38
|
+
return True
|
|
39
|
+
|
|
40
|
+
@mcp.tool()
|
|
41
|
+
def create_note(title: str, content: str, tags: str = "", category: str = "general", api_key: str = "") -> dict[str, Any]:
|
|
42
|
+
"""Create a new note with title, content, optional comma-separated tags and category."""
|
|
43
|
+
allowed, msg, tier = check_access(api_key)
|
|
44
|
+
if not allowed:
|
|
45
|
+
return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
|
|
46
|
+
if err := _rl(): return err
|
|
47
|
+
|
|
48
|
+
if not _rate_check("create_note"):
|
|
49
|
+
return {"error": "Rate limit exceeded (50/day)"}
|
|
50
|
+
tag_list = [t.strip() for t in tags.split(",") if t.strip()] if tags else []
|
|
51
|
+
note_id = hashlib.md5(f"{title}{time.time()}".encode()).hexdigest()[:8]
|
|
52
|
+
note = {
|
|
53
|
+
"id": note_id, "title": title, "content": content,
|
|
54
|
+
"tags": tag_list, "category": category,
|
|
55
|
+
"word_count": len(content.split()),
|
|
56
|
+
"created_at": datetime.utcnow().isoformat()
|
|
57
|
+
}
|
|
58
|
+
_notes.append(note)
|
|
59
|
+
return {"note": note, "total_notes": len(_notes)}
|
|
60
|
+
|
|
61
|
+
@mcp.tool()
|
|
62
|
+
def search_notes(query: str, search_in: str = "all", api_key: str = "") -> dict[str, Any]:
|
|
63
|
+
"""Search notes by keyword. search_in: all, title, content, tags."""
|
|
64
|
+
allowed, msg, tier = check_access(api_key)
|
|
65
|
+
if not allowed:
|
|
66
|
+
return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
|
|
67
|
+
if err := _rl(): return err
|
|
68
|
+
|
|
69
|
+
if not _rate_check("search_notes"):
|
|
70
|
+
return {"error": "Rate limit exceeded (50/day)"}
|
|
71
|
+
q = query.lower()
|
|
72
|
+
results = []
|
|
73
|
+
for note in _notes:
|
|
74
|
+
match = False
|
|
75
|
+
if search_in in ("all", "title") and q in note["title"].lower():
|
|
76
|
+
match = True
|
|
77
|
+
if search_in in ("all", "content") and q in note["content"].lower():
|
|
78
|
+
match = True
|
|
79
|
+
if search_in in ("all", "tags") and any(q in t.lower() for t in note["tags"]):
|
|
80
|
+
match = True
|
|
81
|
+
if match:
|
|
82
|
+
results.append(note)
|
|
83
|
+
return {"query": query, "results": results, "count": len(results)}
|
|
84
|
+
|
|
85
|
+
@mcp.tool()
|
|
86
|
+
def summarize_notes(note_ids: str = "", max_sentences: int = 3, api_key: str = "") -> dict[str, Any]:
|
|
87
|
+
"""Summarize notes. note_ids: comma-separated IDs or empty for all. Extracts key sentences."""
|
|
88
|
+
allowed, msg, tier = check_access(api_key)
|
|
89
|
+
if not allowed:
|
|
90
|
+
return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
|
|
91
|
+
if err := _rl(): return err
|
|
92
|
+
|
|
93
|
+
if not _rate_check("summarize_notes"):
|
|
94
|
+
return {"error": "Rate limit exceeded (50/day)"}
|
|
95
|
+
ids = [i.strip() for i in note_ids.split(",") if i.strip()] if note_ids else None
|
|
96
|
+
target = [n for n in _notes if ids is None or n["id"] in ids] if _notes else []
|
|
97
|
+
if not target:
|
|
98
|
+
return {"error": "No notes found"}
|
|
99
|
+
summaries = []
|
|
100
|
+
for note in target:
|
|
101
|
+
sentences = re.split(r'[.!?]+', note["content"])
|
|
102
|
+
sentences = [s.strip() for s in sentences if s.strip()]
|
|
103
|
+
key = sentences[:max_sentences]
|
|
104
|
+
summaries.append({
|
|
105
|
+
"id": note["id"], "title": note["title"],
|
|
106
|
+
"summary": ". ".join(key) + ("." if key else ""),
|
|
107
|
+
"total_sentences": len(sentences), "shown": len(key)
|
|
108
|
+
})
|
|
109
|
+
return {"summaries": summaries, "notes_processed": len(summaries)}
|
|
110
|
+
|
|
111
|
+
@mcp.tool()
|
|
112
|
+
def export_markdown(note_ids: str = "", include_metadata: bool = True, api_key: str = "") -> dict[str, Any]:
|
|
113
|
+
"""Export notes as Markdown. note_ids: comma-separated or empty for all."""
|
|
114
|
+
allowed, msg, tier = check_access(api_key)
|
|
115
|
+
if not allowed:
|
|
116
|
+
return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
|
|
117
|
+
if err := _rl(): return err
|
|
118
|
+
|
|
119
|
+
if not _rate_check("export_markdown"):
|
|
120
|
+
return {"error": "Rate limit exceeded (50/day)"}
|
|
121
|
+
ids = [i.strip() for i in note_ids.split(",") if i.strip()] if note_ids else None
|
|
122
|
+
target = [n for n in _notes if ids is None or n["id"] in ids] if _notes else []
|
|
123
|
+
if not target:
|
|
124
|
+
return {"error": "No notes found"}
|
|
125
|
+
parts = []
|
|
126
|
+
for note in target:
|
|
127
|
+
md = f"# {note['title']}\n\n"
|
|
128
|
+
if include_metadata:
|
|
129
|
+
md += f"**ID:** {note['id']} | **Category:** {note['category']} | **Created:** {note['created_at']}\n"
|
|
130
|
+
if note["tags"]:
|
|
131
|
+
md += f"**Tags:** {', '.join(note['tags'])}\n"
|
|
132
|
+
md += "\n---\n\n"
|
|
133
|
+
md += note["content"]
|
|
134
|
+
parts.append(md)
|
|
135
|
+
return {"markdown": "\n\n---\n\n".join(parts), "notes_exported": len(parts)}
|
|
136
|
+
|
|
137
|
+
if __name__ == "__main__":
|
|
138
|
+
mcp.run()
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
name: note-taking-ai-mcp
|
|
2
|
+
description: Note Taking Ai automation via MCP. Includes create note, search notes,
|
|
3
|
+
summarize notes. By MEOK AI Labs.
|
|
4
|
+
version: 1.0.0
|
|
5
|
+
tools:
|
|
6
|
+
- name: create_note
|
|
7
|
+
description: Create a new note with title, content, optional comma-separated tags
|
|
8
|
+
and category.
|
|
9
|
+
parameters:
|
|
10
|
+
- name: title
|
|
11
|
+
type: string
|
|
12
|
+
required: true
|
|
13
|
+
- name: content
|
|
14
|
+
type: string
|
|
15
|
+
required: true
|
|
16
|
+
- name: tags
|
|
17
|
+
type: string
|
|
18
|
+
required: false
|
|
19
|
+
- name: category
|
|
20
|
+
type: string
|
|
21
|
+
required: false
|
|
22
|
+
- name: search_notes
|
|
23
|
+
description: 'Search notes by keyword. search_in: all, title, content, tags.'
|
|
24
|
+
parameters:
|
|
25
|
+
- name: query
|
|
26
|
+
type: string
|
|
27
|
+
required: true
|
|
28
|
+
- name: search_in
|
|
29
|
+
type: string
|
|
30
|
+
required: false
|
|
31
|
+
- name: summarize_notes
|
|
32
|
+
description: 'Summarize notes. note_ids: comma-separated IDs or empty for all. Extracts
|
|
33
|
+
key sentences.'
|
|
34
|
+
parameters:
|
|
35
|
+
- name: note_ids
|
|
36
|
+
type: string
|
|
37
|
+
required: false
|
|
38
|
+
- name: max_sentences
|
|
39
|
+
type: integer
|
|
40
|
+
required: false
|
|
41
|
+
- name: export_markdown
|
|
42
|
+
description: 'Export notes as Markdown. note_ids: comma-separated or empty for all.'
|
|
43
|
+
parameters:
|
|
44
|
+
- name: note_ids
|
|
45
|
+
type: string
|
|
46
|
+
required: false
|
|
47
|
+
- name: include_metadata
|
|
48
|
+
type: boolean
|
|
49
|
+
required: false
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
import os
|
|
2
|
+
import sys
|
|
3
|
+
import unittest
|
|
4
|
+
|
|
5
|
+
# Ensure shared auth middleware is available
|
|
6
|
+
sys.path.insert(0, os.path.expanduser("~/clawd/meok-labs-engine/shared"))
|
|
7
|
+
os.chdir(os.path.dirname(os.path.abspath(__file__)) + "/..")
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
class TestMCPImport(unittest.TestCase):
|
|
11
|
+
def test_import_server(self):
|
|
12
|
+
"""Server module must import without errors."""
|
|
13
|
+
import server # noqa: F401
|
|
14
|
+
|
|
15
|
+
def test_mcp_or_server_object_exists(self):
|
|
16
|
+
"""FastMCP servers export 'mcp'; low-level servers export 'server'."""
|
|
17
|
+
import server as srv
|
|
18
|
+
self.assertTrue(
|
|
19
|
+
hasattr(srv, "mcp") or hasattr(srv, "server"),
|
|
20
|
+
"Expected 'mcp' or 'server' object in server.py",
|
|
21
|
+
)
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
class TestAuthMiddleware(unittest.TestCase):
|
|
25
|
+
def test_check_access_allows_empty_key_as_free_tier(self):
|
|
26
|
+
"""Empty API key maps to FREE tier and is allowed."""
|
|
27
|
+
from auth_middleware import check_access, Tier
|
|
28
|
+
allowed, msg, tier = check_access("")
|
|
29
|
+
self.assertTrue(allowed)
|
|
30
|
+
self.assertEqual(tier, Tier.FREE)
|
|
31
|
+
self.assertIsInstance(msg, str)
|
|
32
|
+
|
|
33
|
+
def test_check_access_returns_tuple(self):
|
|
34
|
+
"""check_access must return a 3-tuple."""
|
|
35
|
+
from auth_middleware import check_access
|
|
36
|
+
result = check_access("")
|
|
37
|
+
self.assertIsInstance(result, tuple)
|
|
38
|
+
self.assertEqual(len(result), 3)
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
class TestHealthEndpoint(unittest.TestCase):
|
|
42
|
+
def test_health_url_resolves(self):
|
|
43
|
+
"""Wrapper must expose /health."""
|
|
44
|
+
import urllib.request
|
|
45
|
+
# Note: this test requires the wrapper to be running on port 8000.
|
|
46
|
+
# It is skipped in CI unless the server is active.
|
|
47
|
+
try:
|
|
48
|
+
resp = urllib.request.urlopen("http://localhost:8000/health", timeout=2)
|
|
49
|
+
self.assertEqual(resp.status, 200)
|
|
50
|
+
except Exception as e:
|
|
51
|
+
self.skipTest(f"Server not running: {e}")
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
if __name__ == "__main__":
|
|
55
|
+
unittest.main()
|