hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

The README shows a command for running the web server using Bun as an alternative runtime: 'bun src/notes-web-server.ts --dynamodb ...'
The README mentions Node.js multiple times as the primary runtime for the MCP server, with instructions for configuration in various clients.
The README shows integration with npm through the use of npx commands to run the MCP Notes server and web server.

📝 MCPノート

✨ 概要

MCP Notes Serverは、 MCPプロトコル上に構築されたシンプルなメモ作成アプリケーションです。AIモデルを活用しながら、個人的な考え、メモ、インスピレーション、洞察など、複雑なメモやタスクを記録・閲覧できるようにすることを目指しています。プロジェクトファイルの作成を必要とせず、プロジェクト内で公開することなく、あらゆるコンテンツを記録できます。

このプロジェクトには、AI 駆動型メモ管理用のモデルコンテキストプロトコル (MCP) を使用する Node.js サーバーと、メモを手動で操作するためのユーザーフレンドリーなインターフェイスを提供する Web サーバーの 2 つのサーバーが含まれています。

**注:**このプロジェクトでは、メモの保存に DynamoDB が必要です。ご利用には AWS アカウントが必要です。AWS は DynamoDB に十分な無料利用枠を提供しているため、頻繁に個人でご利用いただく場合でも無料でご利用いただけます。

🎯 コア機能

🖥️デュアルサーバーアーキテクチャ: AI駆動型ノート管理用のMCPサーバーとユーザーインターフェース用のWebサーバー
🤖 AI を活用したメモ作成: AI とのやり取りを通じて、考え、洞察、タスクを記録します
🗂️包括的なメモ管理: AI または Web インターフェースを介してメモを作成、一覧表示、取得、更新、削除します
📋信頼性の高いストレージ: AWS DynamoDB による安全で効率的なノートストレージ
🔐**柔軟な認証:**接続文字列または環境変数を介した AWS 認証情報のサポート
📝**プロジェクトに依存しない:**プロジェクトファイルや構造に影響を与えずに個人的なメモを保存できます

🤖 モデルサポート

クライアントがMCPをサポートしていれば、関数呼び出しをサポートする任意のモデルを使用できます。以下のモデルはテスト済みで動作確認済みです。

クロード3.5シリーズ
ジェミニ1.5および2.0シリーズ
GPT-4シリーズ
ミストラルラージ
グロク2
ディープシークチャット

🛠️ インストール

推奨

npxまたはbunxで直接実行します。以下の例を参照してください。

代替

システムにNode.jsがインストールされていることを確認してください。
このリポジトリをクローンし、依存関係をインストールします: npm install
Claude Desktop またはその他のツールを以下のように設定します。

⚙️ 資格情報の設定

接続文字列

dynamodb://<access_key>:<secret_key>@<region>/<table>

例: dynamodb://AKIAXXXXXXXX:SKXXXXXXXX@us-east-1/mcp-notes

環境変数

AWS_ACCESS_KEY_IDとAWS_SECRET_ACCESS_KEYをエクスポートします。
URI に資格情報なしで接続情報を入力します: dynamodb://us-east-1/mcp-notes

🤖 ツールとの統合

クロードデスクトップ

このスニペットをclaude_desktop_config.jsonに追加します。

{
  "mcpServers": {
    "mcp-notes": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "mcp-notes",
        "mcp-notes-server",
        "--dynamodb",
        "dynamodb://access_key:secret_key@region/table"
      ]
    }
  }
}

またはローカルディスク上のファイル:

{
  "mcpServers": {
    "mcp-notes": {
      "command": "node",
      "args": [
        "file://path/to/notes-mcp-server.js",
        "--dynamodb",
        "dynamodb://access_key:secret_key@region/table"
      ]
    }
  }
}

コーディ

**注:**現在、Cody の MCP サーバーサポートは制限されています。
サーバー接続は1つしか許可されておらず、ツール呼び出しはできません。メモを作成・管理し、AIチャットでの会話で参照するには、Webインターフェースを使用する必要があります。

次のスニペットを VS Code 設定に追加します。

{
  "openctx.providers": {
    "https://openctx.org/npm/@openctx/provider-modelcontextprotocol": {
      "nodeCommand": "node",
      "mcp.provider.uri": "file://path/to/notes-mcp-server.js",
      "mcp.provider.args": [
        "--dynamodb",
        "dynamodb://access_key:secret_key@region/table"
      ]
    }
  }
}

あるいは、 npxを使用します (動作は保証されません)。

{
  "openctx.providers": {
    "https://openctx.org/npm/@openctx/provider-modelcontextprotocol": {
      "nodeCommand": "node",
      "mcp.provider.uri": "file:///usr/local/bin/npx",
      "mcp.provider.args": [
        "-y",
        "-p",
        "mcp-notes",
        "mcp-notes-server",
        "--dynamodb",
        "dynamodb://access_key:secret_key@region/table"
      ]
    }
  }
}

クライン

このスニペットをcline_mcp_settings.jsonに追加します。

「新しいタスク」ボタンの横に「MCP サーバー」アイコンがあり、このファイルを開くための「MCP 設定の編集」ボタンがあります。

{
  "mcpServers": {
    "mcp-notes": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "mcp-notes",
        "mcp-notes-server",
        "--dynamodb",
        "dynamodb://access_key:secret_key@region/table"
      ]
    }
  }
}

🚀 Webサーバーの実行

ウェブサーバーは、メモを管理するためのユーザーフレンドリーなインターフェースを提供します。ウェブインターフェースを起動して、メモを管理したり、AI用の新しいメモを追加したり、AIが生成したメモの一部を変更したりできます。

npx -p mcp-notes mcp-notes-web-server --dynamodb "dynamodb://access_key:secret_key@region/table"

bun src/notes-web-server.ts --dynamodb "dynamodb://access_key:secret_key@region/table"

または、 npm run buildでコンパイルし、 node dist/notes-mcp-server.jsまたはnode dist/notes-web-server.jsを実行します。

次に、ブラウザでhttp://localhost:3100にアクセスしてメモを表示します。

🔧 利用可能なMCPツール

リストノート

入力: { tags?: string[] }
**出力:**すべてのメモの配列。オプションでタグでフィルタリングされます。

ゲットノート

入力: { id: string }
**出力:**指定された ID に一致する単一のノートオブジェクト、または一致するものが存在しない場合は「見つかりません」というメッセージ。

メモを書く

入力: { id: string, title: string, summary: string, tags: string[], content: string }
**出力:**成功確認メッセージ。

削除メモ

入力: { id: string }
**出力:**削除確認メッセージ🚮。

📝 データ構造

メモは次の構造を使用して保存されます。

id : メモの一意の識別子。「meeting-notes-1362」のように、ランダムな数字の接尾辞が付いた、わかりやすい名前にしてください。
title : メモのタイトル。
summary : メモの内容の短い要約。
tags : メモに関連付けられたタグの配列 (例: ["meeting", "project-x"])。
content : ノートの主な内容。

📸 スクリーンショット

クロードデスクトップ

✅ フル機能

コーディ

✅ リソース経由でメモをメンションする

❎ ツール呼び出しはサポートされていません

クライン

✅ ツールコールによるフル機能

❓ リソースが機能していないようです。助けが必要です。

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

AI モデルを使用してメモを記録および管理するためのシンプルなメモ作成 MCP サーバー。

Integrations

📝 MCPノート

✨ 概要

🎯 コア機能

🤖 モデルサポート

🛠️ インストール

⚙️ 資格情報の設定

接続文字列

環境変数

🤖 ツールとの統合

クロードデスクトップ

コーディ

クライン

🚀 Webサーバーの実行

🔧 利用可能なMCPツール

リストノート

ゲットノート

メモを書く

削除メモ

📝 データ構造

📸 スクリーンショット

クロードデスクトップ

コーディ

クライン

Appeared in Searches