Frequently Asked Questions about the Yonote MCP Server Prototype

Q: What is an MCP Server? A: MCP (Model Context Protocol) server acts as a bridge, allowing AI models to access and interact with external data sources and tools. In the case of the Yonote MCP Server, it allows AI agents to access and utilize data within your Yonote documents.

Q: What is Yonote? A: Yonote is a note-taking and document management application, similar to Notion. The Yonote MCP Server Prototype allows AI agents to interact with data stored within Yonote.

Q: What are the key features of the Yonote MCP Server Prototype? A: The key features include listing documents and collections from Yonote, retrieving detailed information about a document, and integration with the FastMCP framework.

Q: What are the requirements for running the Yonote MCP Server Prototype? A: You need Python 3.13+, Yonote API credentials, the required Python packages (specified in pyproject.toml), and uv for dependency management.

Q: How do I install the dependencies? A: Use uv pip install -r requirements.txt or uv pip install . to install the necessary Python packages.

Q: How do I configure the environment variables? A: Create a .env file in the project root directory and add your Yonote API token and (optionally) API base URL.

Q: How do I run the MCP server? A: Run the server using the command python main.py.

Q: What tools does the server expose? A: The server exposes the following tools: documents_list, documents_info, and collections_list.

Q: How can I integrate this MCP server with Cursor? A: Add the configuration example provided in the documentation to your ~/.cursor/mcp.json file, replacing the path with the actual path to your project directory.

Q: Is the Yonote MCP Server Prototype open source? A: Yes, it is licensed under the MIT license (or another license specified in the repository).

Q: How does this relate to UBOS? A: UBOS is a full-stack AI Agent Development Platform. Integrating the Yonote MCP Server with UBOS allows you to build more powerful and sophisticated AI Agents that can access and utilize your Yonote data within the UBOS ecosystem.