Skip to main content
Glama

syplugin-anMCPServer

by OpaqueGlass

A little MCP server for siyuan-note

中文

A plugin that provides MCP service for Siyuan Note.

⚠️ Breaking changes: Upgrading from v0.1.x to v0.2.x introduces breaking changes. CHANGELOG_zh-CN

✨ Quick Start

  • Download from the marketplace or 1. unzip the package.zip in Release, 2. move the folder to workspace/data/plugins/, 3. and rename the folder to syplugin-anMCPServer;
  • Enable the plugin;
  • The plugin listens on port 16806 by default (Host: 127.0.0.1), please use http://127.0.0.1:16806/sse as the server access address;

⭐ If this is helpful to you, please consider giving it a star!

🔧 Supported Tools

  • [Search]
    • Use keyword search;
    • Use SQL search;
  • [Retrieve]
    • Fetch document kramdown by ID;
    • List notebooks;
    • Get back links;
  • [Write]
    • Append content to diary;
    • Append content to a specific document by ID;
    • Create new note by parent ID;

❓ FAQ

  • Q: How to use it in an MCP client?
    Please refer to the later sections;
  • Q: What are some common MCP clients?
    • Refer to: https://github.com/punkpeye/awesome-mcp-clients or https://modelcontextprotocol.io/clients;
  • Q: Does the plugin support authentication?
    • Version v0.2.0 now supports authentication. After setting the authentication token in the plugin settings, the MCP client needs to configure the authorization request header with the value Bearer YourToken;
  • Q: What is the connection count?
    • In SSE mode, this represents an active SSE connection. Due to clients not disconnecting properly or unknown software connections, the count may fluctuate;
    • In Streamable HTTP mode and the current plugin implementation, the connection count is always 0;
  • Q: Can it be used in Docker?
    • No, the plugin relies on a Node.js environment and does not support running on mobile devices or Docker.

      To support SiYuan deployed in Docker, it is recommended to switch to other MCP projects. Some relevant projects may be listed here.

      Alternatively, decouple this plugin from the SiYuan frontend.

How to Configure in an MCP Client?

Different MCP clients require different configuration methods. Please refer to the MCP client documentation.

MCP clients are continuously updated, so the configuration or usage instructions here may not be directly applicable and are for reference only.

Here, we assume: the plugin’s port is 16806, and the authorization token is abcdefg.

Modify the MCP application’s configuration, select the Streamable HTTP type, and configure the endpoint.

Clients Supporting Streamable HTTP

The following configuration uses Cherry Studio as an example. Different MCP clients may require different configuration formats—please refer to the MCP client documentation.

Plugin Without Authorization Token

  1. Type: Select Streamable HTTP (streamablehttp);
  2. URL: http://127.0.0.1:16806/mcp;
  3. Headers: Leave empty;

Plugin With Authorization Token

  1. Type: Select Streamable HTTP (streamablehttp);
  2. URL: http://127.0.0.1:16806/mcp;
  3. Headers: Authorization=Bearer abcedfg;

Clients Supporting Only Stdio

If the MCP client does not support HTTP-based communication and only supports stdio, a conversion method is needed.

Here, we use node.js + mcp-remote@next.

  1. Download Node.js: https://nodejs.org/en/download
  2. Install mcp-remote@next:
npm install -g mcp-remote@next

The following configuration uses 5ire as an example. Different MCP clients may require different configuration formats—please refer to the MCP client documentation.

Plugin Without Authorization Token

Command:

npx mcp-remote@next http://127.0.0.1:16806/mcp

Plugin With Authorization Token

Command:

npx mcp-remote@next http://127.0.0.1:16806/mcp --header Authorization:${AUTH_HEADER}

Environment Variable:

Name: AUTH_HEADER
Value: Bearer abcdefg

🙏 References & Acknowledgements

Some dependencies are listed in package.json.

Developer/ProjectProject DescriptionCitation
thuanpham582002/tabby-mcp-serverProvides MCP service within the terminal software Tabby; MIT LicenseImplementation method of MCP service
-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

A Model Context Protocol server plugin for SiYuan note-taking application that enables searching documents, retrieving content, and writing to notes through an HTTP-based interface.

  1. ✨ Quick Start
    1. 🔧 Supported Tools
      1. ❓ Frequently Asked Questions
        1. 🙏 References & Acknowledgements

          Related MCP Servers

          • -
            security
            F
            license
            -
            quality
            A TypeScript-based MCP server that enables users to manage text notes with features like note creation and summary generation using a Model Context Protocol.
            Last updated -
            1
            • Apple
          • -
            security
            F
            license
            -
            quality
            A Model Context Protocol server that enables semantic search and retrieval of Apple Notes content, allowing AI assistants to access, search, and create notes using on-device embeddings.
            Last updated -
            2
            • Apple
          • A
            security
            F
            license
            A
            quality
            A model context protocol server that allows interaction with TriliumNext Notes, providing tools to create, search, retrieve, update, and delete notes through natural language commands.
            Last updated -
            5
            604
            14
            • Apple
          • A
            security
            A
            license
            A
            quality
            An MCP server implementation that integrates with SiYuan Note system, enabling AI models to access and manipulate note data through comprehensive commands for notebook management, document operations, and content manipulation.
            Last updated -
            3
            12
            39
            ISC License
            • Linux
            • Apple

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/OpaqueGlass/syplugin-anMCPServer'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server