金大哥 - WeiWanMcpServer MCP 详情

article

README

🚀 Show Time：AI极客马拉松项目 - 超能聊天 + 自定义MCP服务器

本项目是在AI极客马拉松竞赛中诞生的成果，结合了超能聊天（开源聊天客户端）与自定义MCP服务器。通过聊天交互调用MCP工具，实现网络资讯检索、笔记下载、管理与复写等功能，为用户提供便捷的知识管理体验。

🚀 快速开始

在本次AI极客马拉松竞赛里，项目实现了一个基于超能聊天和自定义MCP服务器的程序。借助聊天交互调用MCP工具，达成如下核心功能：

网络资讯检索：能在指定站点（像知乎）检索与关键词相关的资料，以链接 + 摘要的形式返回。
笔记下载：可把检索到的链接内容下载成Markdown笔记，保存到本地笔记仓库。
笔记管理：能对笔记开展查看、总结、删除等操作（基于Obsidian的开源实现）。
笔记复写：可对下载的笔记进行内容复写或整理。

✨ 主要特性

无缝集成：借助超能聊天实现自然语言交互，降低用户学习成本。
高效检索：支持指定站点检索，能快速获取目标资讯。
本地化管理：将网络内容保存为Markdown笔记，便于后续整理和复用。
灵活性：支持笔记复写和Obsidian集成，满足个性化需求。

📦 安装指南

文档未提及安装步骤，暂不展示。

💻 使用示例

基础用法

from mcp.server.fastmcp import FastMCP
from datetime import datetime
import os
import requests
import re

mcp = FastMCP("WeiWanMcp", instructions="""
    限制:
        1.调用search_news查询资讯后,不要对内容进行总结,直接进行输出.
""")

nodePath = os.getenv("NOTES_PATH", "E:\MyDocuments\MyNotes\Clipper")

@mcp.tool()
def search_news(query: str, website: str):
    """检索网络资讯"""
    url = 'https://s.jina.ai/?q=' + query + '&num=20'
    headers = {
        'Authorization': 'Bearer YOUR_API_KEY',
        'X-Respond-With': 'no-content',
    }
    if website:
        if validate_domain(website):
            headers['X-Site'] = website
    response = requests.get(url, headers=headers)
    return response.text

@mcp.tool()
def download_note(webLink: str, nodeTitle: str):
    """下载网页内容为笔记"""
    headers = {"Authorization": "Bearer YOUR_API_KEY"}
    response = requests.get("https://r.jina.ai/" + webLink, headers=headers)
    with open(nodePath + "\\" + nodeTitle + ".md", "w", encoding='utf-8') as file:
        file.write(response.text)
    return "笔记已保存至: " + nodePath + "\\" + nodeTitle + ".md"

@mcp.tool()
def overwrite_note(webLink: str, nodeTitle: str):
    """复写或整理笔记内容"""
    headers = {"Authorization": "Bearer YOUR_API_KEY"}
    response = requests.get("https://r.jina.ai/" + webLink, headers=headers)
    with open(nodePath + "\\" + nodeTitle + ".md", "w", encoding='utf-8') as file:
        file.write(response.text)
    return "笔记已复写至: " + nodePath + "\\" + nodeTitle + ".md"

高级用法

文档未提及高级用法相关代码，暂不展示。

📚 详细文档

🔧 技术细节

1. 核心组件

超能聊天：作为用户交互的前端，支持聊天式调用MCP工具。
自定义MCP服务器：基于Python实现，提供以下工具：
- search_news: 检索网络资讯。
- download_note: 下载网页内容为Markdown笔记。
- overwrite_note: 复写或整理笔记内容。
- 其他辅助工具（如获取当前时间、日期等）。

2. 代码亮点

服务器端代码实现了网络资讯的检索、下载和复写功能，支持指定站点（如知乎）的精准搜索。使用requests库进行HTTP请求处理，确保数据获取高效稳定。笔记内容存储在本地Markdown文件中，便于后续编辑和管理。

🌟 项目亮点

无缝集成：通过超能聊天实现自然语言交互，降低用户学习成本。
高效检索：支持指定站点检索，快速获取目标资讯。
本地化管理：将网络内容保存为Markdown笔记，方便后续整理和复用。
灵活性：支持笔记复写和Obsidian集成，满足个性化需求。

🚀 未来展望

扩展工具集：增加更多MCP工具（如翻译、摘要生成等）。
多平台支持：适配更多笔记软件（如Notion、Logseq）。
性能优化：提升检索和下载速度，优化用户体验。

📷 功能截图

项目界面操作流程结果展示

📄 结语

本次项目结合超能聊天和自定义MCP服务器，实现了从资讯检索到笔记管理的全流程自动化。未来会进一步优化功能，为用户提供更强大的知识管理工具！

WeiWanMcpServer