使用说明

项目简介

wrale_mcp-server-yahoo-finance 是一个基于 Model Context Protocol (MCP) 的服务器实现，专注于提供笔记管理功能。它演示了如何使用 MCP 协议构建一个能够与 LLM 客户端交互的后端服务，通过资源、Prompt 和工具三种核心机制，实现了笔记的增删查以及总结能力。

主要功能点

笔记资源管理: 通过自定义 'note://' URI scheme 提供对笔记的访问能力。每个笔记被视为一个资源，包含名称、描述和文本内容。
笔记总结 Prompt: 提供 'summarize-notes' Prompt，允许 LLM 客户端请求服务器生成所有笔记的摘要，并支持通过 'style' 参数控制摘要的详细程度（简要或详细）。
添加笔记工具: 提供 'add-note' 工具，允许 LLM 客户端指示服务器创建新的笔记，需要提供笔记的名称和内容。当笔记添加成功后，服务器会通知客户端资源列表已更改。

安装步骤

本MCP服务器主要用于演示和开发目的，通常无需手动安装。对于 Claude Desktop 等 MCP 客户端，您可以通过配置服务器启动命令来连接和使用此服务器。以下是配置方法：

找到 Claude Desktop 配置文件: 根据您的操作系统，找到 Claude Desktop 的配置文件 'claude_desktop_config.json'。
- MacOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%/Claude/claude_desktop_config.json'
编辑配置文件: 打开 'claude_desktop_config.json' 文件，在 '"mcpServers"' 字段下添加或修改服务器配置信息。

服务器配置

以下是配置 wrale_mcp-server-yahoo-finance MCP 服务器的 JSON 代码，您需要将其添加到 Claude Desktop 的 'claude_desktop_config.json' 文件中的 '"mcpServers"' 字段下。

开发环境配置 (Development/Unpublished Servers Configuration):

如果您希望在本地开发环境中运行此服务器，可以使用以下配置。请务必将 '"args"' 中的目录路径 '/Users/josh/src/mcp-server-yahoo-finance' 替换为您实际的项目代码存放路径。

"mcp-server-yahoo-finance": {
  "command": "uv",
  "args": [
    "--directory",
    "/Users/josh/src/mcp-server-yahoo-finance",  // 替换为您的项目实际路径
    "run",
    "mcp-server-yahoo-finance"
  ]
}

发布环境配置 (Published Servers Configuration):

如果服务器已打包发布，可以使用以下配置。这假设 'mcp-server-yahoo-finance' 可通过 'uvx' 命令直接运行。

"mcp-server-yahoo-finance": {
  "command": "uvx",
  "args": [
    "mcp-server-yahoo-finance"
  ]
}

请注意：MCP 客户端会根据您提供的 'command' 和 'args' 启动 MCP 服务器进程，并与之建立连接。您无需手动启动服务器。

基本使用方法

配置 MCP 客户端: 按照上述 "服务器配置" 步骤，将相应的 JSON 配置添加到您的 MCP 客户端（如 Claude Desktop）的配置文件中。
连接服务器: 启动或重启 MCP 客户端。客户端应该能够自动连接到您配置的 MCP 服务器。
使用笔记功能: 在 MCP 客户端中，您应该能够看到 wrale_mcp-server-yahoo-finance 服务器提供的功能，例如：
- 使用 "add-note" 工具创建新的笔记。
- 使用 "summarize-notes" Prompt 获取笔记摘要。
- 客户端可能会以某种方式展示可用的笔记资源，具体取决于客户端的实现。

具体的使用方式和界面操作会依赖于您使用的 MCP 客户端。请参考您使用的 MCP 客户端的文档以获取更详细的使用指导。

关键词