notellm MCP server

NoteLLM_MCP_服务器

跳转至 中文说明

NoteLLM_MCP_Server是一款开源软件，旨在通过Joplin插件的API提供MCP服务 NoteLLM.

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

image-20250804125754732

特性

• 与各种MCP工具集成兼容：支持通过标准JSON文件添加MCP工具，使工具集成简单直观。
• 基于API的MCP服务模式：建立在FastAPI框架之上，为调用MCP服务提供了API端点，实现了高效便捷的集成和使用。
• 多种MCP服务模式：通过配置 mode 参数，您可以启用不同的运行模式，包括 stdio, sse，以及 streamableHTTP这些模式可以组合在一起，以支持各种MCP工具集成，并提供统一的MCP服务端点，从而可以作为MCP提供商与CherryStudio等工具集成。

安装与使用

步骤1：配置MCP工具

将存储库克隆到您的计算机。

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

安装带有uv的软件包：

uv sync

复制 mcp_gonfig.example.json 向 mcpconfig.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"
            }
        }
    }
}

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

启动服务器：

uv run mcp_server.py

它将继续运行http://127.0.0.1:7302默认情况下。

您还可以添加 --host 和 --port 随心所欲地奔跑。

步骤3：更改Joplin插件NoteLLM的设置

转到设置 NoteLLM >=v0.6.0，

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

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

祝贺您的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": "local mcp server",
            "isActive": true,
            "tags": [],
            "baseUrl": "http://127.0.0.1:7302/sse"
        }
    }
}

技术栈

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

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

用例

注意LLM_MCP_Server可用于需要MCP服务集成和配置的各种场景，例如：

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

更新日志

版本|日期|详细信息 --|--|-- v0.1.0|2025-08-03|基本功能的初步实现