关键词

笔记管理文本总结知识库效率工具LLM应用

使用说明

项目简介

mcp-server-yahoo-finance 是一个基于 Model Context Protocol (MCP) 构建的服务器示例，专注于提供简单的笔记管理功能。它允许 LLM 客户端通过标准化的 MCP 协议与服务器交互，实现笔记的创建、存储和总结。

主要功能点

  • 资源 (Resources): 提供笔记资源的管理。每篇笔记都以 'note://' URI 格式对外暴露，客户端可以通过 URI 访问特定笔记。
  • Prompt 模板 (Prompts): 提供 'summarize-notes' Prompt 模板，用于总结所有已存储的笔记内容。用户可以可选地指定 'style' 参数（'brief' 或 'detailed'）来控制总结的详细程度。
  • 工具 (Tools): 提供 'add-note' 工具，允许客户端向服务器添加新的笔记。添加笔记时需要提供笔记的 'name' 和 'content'。当笔记资源发生变化时，服务器会通知客户端。

安装步骤

该 MCP 服务器无需传统意义上的“安装”步骤。它是一个 Python 项目，您需要确保您的环境中安装了 Python 和 'uv' 包管理器（仓库 README.md 中使用了 'uv' 命令）。

  1. 克隆仓库: 首先，将 'mcp-server-yahoo-finance' 仓库克隆到本地：

    git clone https://github.com/wrale/mcp-server-yahoo-finance
cd mcp-server-yahoo-finance

  2. 同步依赖: 使用 'uv' 同步项目依赖：

    uv sync

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）连接，您需要在客户端的配置文件中添加服务器配置信息。以下是配置示例，您需要根据您的实际情况进行调整。

针对开发环境/未发布的服务器配置 (Development/Unpublished Servers Configuration):

"mcpServers": {
  "mcp-server-yahoo-finance": {
    "command": "uv",  // 启动服务器的命令，这里使用 uv
    "args": [         // 启动命令的参数列表
      "--directory",  // 指定工作目录
      "/path/to/mcp-server-yahoo-finance", // 替换为您的 mcp-server-yahoo-finance 仓库的本地路径
      "run",          // uv 的 run 命令，用于运行 Python 包
      "mcp-server-yahoo-finance" // 要运行的 Python 包名称，与仓库名一致
    ]
  }
}

针对已发布的服务器配置 (Published Servers Configuration):

如果您已将此服务器打包并发布，可以使用以下配置：

"mcpServers": {
  "mcp-server-yahoo-finance": {
    "command": "uvx", // 启动已发布包的命令，这里使用 uvx
    "args": [        // 启动命令的参数列表
      "mcp-server-yahoo-finance" // 已发布的包名称
    ]
  }
}

注意:

  • 您需要将 '/path/to/mcp-server-yahoo-finance' 替换为您本地 'mcp-server-yahoo-finance' 仓库的实际路径。
  • MCP 客户端（如 Claude Desktop）会读取这些配置信息，并根据 'command' 和 'args' 启动 MCP 服务器进程。

基本使用方法

  1. 启动 MCP 服务器: 配置完成后，当 MCP 客户端启动时，它会根据您提供的配置信息自动启动 'mcp-server-yahoo-finance' 服务器。

  2. 与 LLM 客户端交互:

    • 查看笔记列表: LLM 客户端可以请求服务器列出所有可用的资源（笔记）。服务器会返回笔记列表，每篇笔记都有一个 'note://' 格式的 URI。
    • 读取笔记内容: LLM 客户端可以使用笔记的 URI 向服务器请求读取笔记内容。
    • 总结笔记: LLM 客户端可以调用 'summarize-notes' Prompt 模板，让服务器生成所有笔记的摘要。客户端可以选择传递 'style' 参数 ('brief' 或 'detailed') 来控制摘要的详细程度。
    • 添加笔记: LLM 客户端可以调用 'add-note' 工具，向服务器添加新的笔记。调用工具时需要提供 'name' 和 'content' 参数。

通过以上步骤，您可以使用 LLM 客户端与 'mcp-server-yahoo-finance' 服务器进行交互，实现笔记的存储、管理和总结功能。

信息

分类

生产力应用

访问项目