{
"mcpServers": {
"siyuan-mcp-server": {
"command": "<see-readme>",
"args": []
}
}
}No install config available. Check the server's README for setup instructions.
Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
思源笔记MCP / SiYuan MCP Server
Is it safe?
No package registry to scan.
No authentication — any process on your machine can connect.
MIT. View license →
Is it maintained?
Last commit 34 days ago. 51 stars.
Will it work with my client?
Transport: stdio. Works with Claude Desktop, Cursor, Claude Code, and most MCP clients.
No automated test available for this server. Check the GitHub README for setup instructions.
No known vulnerabilities.
This server is missing a description. Tools and install config are also missing.If you've used it, help the community.
Add informationHave you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Persistent memory using a knowledge graph
Privacy-first. MCP is the protocol for tool access. We're the virtualization layer for context.
Pre-build reality check. Scans GitHub, HN, npm, PyPI, Product Hunt — returns 0-100 signal.
Monitor browser logs directly from Cursor and other MCP compatible IDEs.
MCP Security Weekly
Get CVE alerts and security updates for Siyuan_mcp_server and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
A Model Context Protocol (MCP) server for SiYuan Note, providing complete SiYuan API functionality.
# Run directly (local SiYuan)
npx -y siyuan-mcp@latest
# Set environment variables for local access
SIYUAN_HOST=127.0.0.1 SIYUAN_PORT=6806 SIYUAN_TOKEN=your-token npx -y siyuan-mcp@latest
# For remote SiYuan behind HTTPS reverse proxy
SIYUAN_URL=https://siyuan.example.com SIYUAN_TOKEN=your-token npx -y siyuan-mcp@latest
# Pull image
docker pull zhizhiqq/siyuan-mcp:latest
# Run container
docker run -d \
-e SIYUAN_HOST=127.0.0.1 \
-e SIYUAN_PORT=6806 \
-e SIYUAN_TOKEN=your-token \
--name siyuan-mcp-server \
zhizhiqq/siyuan-mcp:latest
{
"mcpServers": {
"siyuan-mcp": {
"command": "npx",
"args": ["-y", "siyuan-mcp@latest"],
"env": {
"SIYUAN_HOST": "127.0.0.1",
"SIYUAN_PORT": "6806",
"SIYUAN_TOKEN": "your-api-token-here"
}
}
}
}
{
"mcpServers": {
"siyuan-mcp": {
"command": "npx",
"args": ["-y", "siyuan-mcp@latest"],
"env": {
"SIYUAN_HOST": "127.0.0.1",
"SIYUAN_PORT": "6806",
"SIYUAN_TOKEN": "your-api-token-here"
}
}
}
}
If your SiYuan instance is behind a reverse proxy (e.g., Traefik, nginx) with HTTPS:
{
"mcpServers": {
"siyuan-mcp": {
"command": "npx",
"args": ["-y", "siyuan-mcp@latest"],
"env": {
"SIYUAN_URL": "https://siyuan.example.com",
"SIYUAN_TOKEN": "your-api-token-here"
}
}
}
}
If you use Docker to run the service, you can configure the client to connect to the Docker container:
Cursor Docker Configuration
{
"mcpServers": {
"siyuan-mcp": {
"command": "docker",
"args": ["run", "--rm", "-e", "SIYUAN_HOST=127.0.0.1", "-e", "SIYUAN_PORT=6806", "-e", "SIYUAN_TOKEN=your-api-token-here", "zhizhiqq/siyuan-mcp:latest"],
"env": {}
}
}
}
Claude Desktop Docker Configuration
{
"mcpServers": {
"siyuan-mcp": {
"command": "docker",
"args": ["run", "--rm", "-e", "SIYUAN_HOST=127.0.0.1", "-e", "SIYUAN_PORT=6806", "-e", "SIYUAN_TOKEN=your-api-token-here", "zhizhiqq/siyuan-mcp:latest"],
"env": {}
}
}
}
Note: When using Docker configuration, ensure Docker is installed and running.
| Variable | Description | Default | Required |
|----------|-------------|---------|----------|
| SIYUAN_URL | Full URL for SiYuan (e.g., https://siyuan.example.com). If set, overrides HOST/PORT. | - | No |
| SIYUAN_HOST | SiYuan server address | 127.0.0.1 | No |
| SIYUAN_PORT | SiYuan server port | 6806 | No |
| SIYUAN_TOKEN | API token | - | Yes |
Note: Use SIYUAN_URL when connecting to a SiYuan instance behind an HTTPS reverse proxy. When SIYUAN_URL is set, SIYUAN_HOST and SIYUAN_PORT are ignored.
A: Please check the following steps:
A:
Settings → About → API TokenGenerate Token or copy existing token