Yonote MCP サーバー プロトタイプ

これは、Notionの代替となるYonoteサービス用のMCPサーバーのMVPプロジェクトです。このサーバーは、Yonoteのドキュメントやコレクションを操作するためのAPIツールを提供します。

特徴

• Yonote からドキュメントとコレクションを一覧表示する

• 文書の詳細情報を取得する

• FastMCPフレームワークを介してツールを公開する

Related MCP server: mcp-discord-chat MCP server

要件

• Python 3.13以上

• Yonote API 資格情報

• 次の Python パッケージ ( pyproject.tomlを参照)。

  • fast-agent-mcp>=0.2.23

  • requests>=2.32.3

  • python-dotenv （環境変数を読み込むため）

• 依存関係管理のためのuv

設定

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Yonote Document Interaction Server を自動的にインストールするには:

手動インストール

1. リポジトリをクローンします。

   git clone <your-repo-url> cd yonote-mcp

2. uv を使用して依存関係をインストールします。

   uv pip install -r requirements.txt # or, using pyproject.toml: uv pip install .

3. 環境変数を設定します。

   プロジェクト ルートに次の内容の.envファイルを作成します。

   API_TOKEN=your_yonote_api_token API_BASE_URL=https://app.yonote.ru/api # Optional, defaults to this value

使用法

MCP サーバーを実行します。

サーバーは次のツールを公開します。

• documents_list : ドキュメントのリストを取得します（オプションで制限、オフセット、コレクションIDを指定）

• documents_info : IDでドキュメントの情報を取得する

• collections_list : コレクションのリストを取得します（オプションで制限とオフセットを指定可能）

プロジェクト構造

• main.py — メインサーバーのコードとツールの定義

• pyproject.toml — プロジェクトのメタデータと依存関係

ライセンス

MIT（またはライセンスを指定）

カーソル設定例

この MCP サーバーを Cursor で使用するには、 ~/.cursor/mcp.json構成ファイルに次のコードを追加します。

/path/to/yonote-mcpプロジェクト ディレクトリへの実際のパスに置き換えます。