Yonote MCP Server

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

これは、Notionの代替サービスであるYonoteサービス用のMCP（マルチチャネルプラットフォーム）サーバーのMVPプロジェクトです。このサーバーは、Yonoteのドキュメントやコレクションを操作するためのAPIツールを提供します。

特徴

• Yonote からドキュメントとコレクションを一覧表示する
• 文書の詳細情報を取得する
• FastMCPフレームワークを介してツールを公開する

要件

• Python 3.13以上
• Yonote API 資格情報
• 次の Python パッケージ ( pyproject.tomlを参照)。
  • fast-agent-mcp>=0.2.23
  • requests>=2.32.3
  • python-dotenv （環境変数を読み込むため）
• 依存関係管理のためのuv

設定

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プロジェクト ディレクトリへの実際のパスに置き換えます。