NoteLLM_MCP_Server

跳转至 中文说明

NoteLLM_MCP_Server 是一个开源软件，旨在通过 API 为 Joplin 插件 NoteLLM 提供 MCP 服务。

它也可以作为一个通用的 MCP 服务提供商通过 API 提供服务，或者通过 stdio、SSE 或 streamableHTTP 提供标准的 MCP 访问。

特性

• 支持多种 MCP 工具集成：支持通过标准 JSON 文件添加 MCP 工具，使工具集成简单直观。
• 基于 API 的 MCP 服务模式：基于 FastAPI 框架构建，提供 API 端点以调用 MCP 服务，实现高效便捷的集成和使用。
• 多种 MCP 服务模式：通过配置 mode 参数，可以启用不同的运行模式，包括 stdio、sse 和 streamableHTTP。这些模式可以组合使用，支持各种 MCP 工具集成，并提供统一的 MCP 服务端点，使其能够作为工具如 CherryStudio 的 MCP 提供商进行集成。

安装与使用

第一步：配置你的 MCP 工具

将仓库克隆到你的计算机上。

git clone git@github.com:HorseSword/notellm_mcp_server.git

安装依赖包：

uv sync

复制 mcp_config.example.json 到 mcp_config.json，并编辑为标准的 MCP 配置 JSON 文件，例如：

{
    "mcpServers": {
        "stdio-server-npx": {
            "command": "npx",
            "args": ["-y", "mcp-name"]
        },
        "stdio-server-uvx": {
            "command": "uvx",
            "args": "mcp-name"
        },
        "stdio-server-python": {
            "command": "uv",
            "args": ["run", "python_code.py"]
        },
        "sse-server-name": {
            "type": "sse",
            "url": "http://localhost:11111"
        },
        "streamable-http-name": {
            "type": "streamableHttp",
            "url": " "http://localhost:22222",
            "headers": {
                "Content-Type": "application/json",
                "Authorization": "Bearer YOUR_TOKEN"
            }
        }
    }
}

第二步：作为 RESTful API 服务器运行，用于 Joplin-Plugin-NoteLLM

启动服务器：

uv run mcp_server.py

默认情况下，它将在 http://127.0.0.1:7302 上运行。

你还可以通过添加 --host 和 --port 来按需运行。

第三步：更改 Joplin-Plugin-NoteLLM 设置

进入 NoteLLM >= v0.6.0 的设置，

(1) 找到“高级设置”，并填写“MCP 服务器 URL（预览）”部分。

(2) 将“MCP for LLM（预览）”从“OFF”更改为“MCP（工具调用）”在 LLM1 至 LLM3 下。提醒：你的模型必须支持“工具调用”。

恭喜！现在你的 NoteLLM 可以使用 MCP 工具了。

可选步骤：作为普通 MCP 服务器运行

你也可以将此服务器用作普通的 MCP 提供商，所有 MCP 都可以一起使用。例如：

uv run mcp_server.py --mode stdio 用于 STDIO MCP；

uv run mcp_server.py --mode sse 用于 SSE MCP；

uv run mcp_server.py --mode http 用于 StreamableHTTP MCP。

你可以将其配置如下：

{
    "mcpServers": {
        "ANYTHING_HERE": {
            "name": "NoteLLM_MCP_Server",
            "type": "sse",
            "description": "本地 MCP 服务器",
            "isActive": true,
            "tags": [],
            "baseUrl": "http://127.0.0.1:7302/sse"
        }
    }
}

技术栈

NoteLLM_MCP_Server 主要采用以下技术构建：

• FastMCP：处理 MCP 协议的核心逻辑。
• FastAPI：构建高性能 API 服务器，提供 RESTful API 调用 MCP 服务。

使用场景

NoteLLM_MCP_Server 可以在需要 MCP 服务集成和提供的各种场景中使用，例如：

• 为 Joplin 插件 NoteLLM 提供 MCP 功能。
• 作为工具如 CherryStudio 的 MCP 提供商。
• 在本地或云中部署，提供统一的 MCP 服务接口。
• 通过 API 端点远程调用和管理 MCP 服务。

更新日志

版本	日期	详情
v0.1.0	2025-08-03	基本功能的初始实现