WeiWanMcpServer

What is WeiWanMcpServer?

WeiWanMcpServer is a custom MCP server built for the AI Hackathon that integrates with HyperChat (an open-source chat client). It enables web search, note downloading, note management, and note overwriting via chat-based tool calls. Designed for users who want to retrieve and manage knowledge from specified websites and store notes locally in Markdown format, with optional Obsidian integration.

How to use WeiWanMcpServer?

Set the environment variable NOTES_PATH to your local note repository path. Use HyperChat as the frontend to invoke MCP tools such as search_news, download_note, and overwrite_note. Provide an API key for Jina.ai services (placeholder YOUR_API_KEY in the code).

Key features of WeiWanMcpServer

• search_news: retrieve web content from specified sites (e.g., zhihu.com) with link+summary output.
• download_note: download a webpage as a Markdown file to the local note repository.
• overwrite_note: overwrite or reorganize the content of an existing note.
• Auxiliary tools: get current date/time.
• Obsidian integration: view, delete, rename, and search notes via obsidian_mcp.

Use cases of WeiWanMcpServer

• Search for MCP-related articles on zhihu.com and get clickable links with summaries.
• Download a specific search result as a Markdown note for offline reading.
• Rewrite or reorganize the content of a downloaded note.
• Manage a local note collection using Obsidian-based tools.

FAQ from WeiWanMcpServer

What API keys are required?

The server uses a placeholder YOUR_API_KEY for Jina.ai endpoints (s.jina.ai and r.jina.ai). You must replace it with a valid API key.

Where are notes stored?

Notes are saved as .md files in the directory specified by the NOTES_PATH environment variable (default E:\MyDocuments\MyNotes\Clipper).

Can I search only specific websites?

Yes. The search_news tool accepts a website parameter. If provided, it sets the X-Site header to restrict results to that domain (e.g., zhihu.com).

What limitations does the server have?

The search_news tool is instructed to return raw search results without summarization. The server runs locally and requires an active internet connection for web searches.

Which transports and authentication are supported?

The server uses the standard MCP JSON-RPC transport (via stdio or HTTP depending on the FastMCP configuration). No built-in authentication is documented beyond the API key for external services.