findmcp

findmcp

0
developer_toolscommunication

FindMCP is a Model Context Protocol (MCP) server providing directory information and support for Smithery.ai services. It's designed for seamless integration with the Cursor editor, offering quick URL lookup and full MCP protocol compatibility.

MCP 官方文档

https://modelcontextprotocol.io/llms-full.txt https://github.com/modelcontextprotocol/typescript-sdk

FindMCP - MCP 服务目录工具

这是一个简单的 MCP 服务器，名为 FindMCP，提供 MCP 服务的目录信息。

功能特点

  • 提供 MCP 服务目录
  • 完全兼容 MCP 协议
  • 专为 Cursor 设计

支持的 MCP 服务

目前提供以下 MCP 服务的目录信息：

安装与配置

本地安装

npm install

本地启动服务

使用提供的启动脚本：

./start-mcp.sh

或直接使用 npm：

npm start

在Smithery.ai上部署

您也可以将此MCP服务部署到Smithery.ai平台：

  1. 访问 https://smithery.ai/new
  2. 点击"Connect with GitHub"连接您的GitHub账号
  3. 将代码推送到GitHub仓库
  4. 在Smithery.ai上选择您的仓库并配置服务
  5. 点击部署按钮完成部署

部署后，您将获得一个Smithery.ai提供的URL，可以在Cursor中使用该URL访问您的MCP服务。

Smithery部署配置文件

本项目包含以下Smithery部署所需的配置文件：

Dockerfile
FROM node:18-alpine

WORKDIR /app

COPY package*.json ./
RUN npm install

COPY . .

CMD ["node", "src/index.js"]
smithery.yaml
command:
  function: node src/index.js

这些配置文件是Smithery.ai平台部署所必需的，它们定义了如何构建和运行MCP服务。

在 Cursor 中使用

添加 MCP 服务器

在 Cursor 中添加此 MCP 服务器：

  1. 打开 Cursor 设置（点击左下角齿轮图标）
  2. 找到 MCP Servers 部分
  3. 点击 "Add new MCP server"
  4. 填写以下信息：
    • 名称：FindMCP
    • 类型：command
    • 命令：输入完整的绝对路径，例如： 
      /Users/chengfeng/Desktop/代码/MCP合集/MCP-cursor/start-mcp.sh
      或者使用更可靠的方式： 
      cd /Users/chengfeng/Desktop/代码/MCP合集/MCP-cursor && npm start

重要提示：如果路径中包含中文或空格，请确保正确转义。最好使用启动脚本而不是直接使用 npm start 命令。

告诉 LLM 使用 MCP 服务

要让 Cursor 中的 LLM 使用 MCP 服务，您需要在对话中明确指示 LLM：

  1. 直接指令方式：

    请使用 smithery_search 工具查询MCP服务

  2. 简洁语法方式：

    @https://smithery.ai/

LLM 应该会识别这些指令并调用相应的 MCP 工具。

可用工具

服务器提供以下工具：

  • smithery_search: 返回Smithery.ai网址，用于查询更多MCP服务

使用示例

使用Smithery查询工具

要使用Smithery查询工具，您可以在对话中使用以下指令：

请使用smithery_search工具查询MCP服务

或者使用更简洁的方式：

@https://smithery.ai/

系统将返回Smithery.ai网站的链接，您可以访问该网站查看完整的MCP服务列表。

故障排除

如果遇到 "Failed to create client" 错误：

  1. 确保使用正确的路径和转义字符
  2. 尝试重启 Cursor
  3. 检查 MCP 服务器是否正常运行
  4. 考虑将项目移动到没有中文字符和空格的路径

如果遇到 "Unexpected token 'H', 'Hello World 工具被调用' is not valid JSON" 错误：

  1. 这是因为服务器在标准输出中混入了调试信息，干扰了JSON通信
  2. 已修复：将console.log改为console.error，确保调试信息输出到stderr而不是stdout
  3. 如果仍然出现此问题，请检查src/index.js中的所有console.log调用，确保它们都使用console.error

如果 LLM 不使用 MCP 工具：

  1. 确保 MCP 服务器已成功连接（在 Cursor 设置中显示为 "Enabled"）
  2. 使用更明确的指令，直接提及工具名称
  3. 尝试重新启动对话
  4. 检查 Cursor 控制台是否有错误信息

调试

如果需要调试 MCP 服务器：

  1. 在终端中手动运行服务器：npm start
  2. 查看输出日志，检查是否有错误信息
  3. 确保 MCP 服务器能够正常启动和运行

项目状态

这是一个完整的 MCP 服务器实现，基于 Model Context Protocol 规范开发。服务器使用 @modelcontextprotocol/sdk 包构建，通过标准输入输出与 Cursor 等客户端通信。

最近更新

  • 2024-03-08: 修复了JSON解析错误，优化了日志记录，简化了代码结构
  • 版本: 1.0.0

smithery badge

FindMCP

FindMCP 是一个 MCP（Model Context Protocol）服务，专门用于提供 Smithery.ai 网址查询功能。它是 Cursor 编辑器 AI 功能的扩展工具。

功能特点

  • 🔍 快速查询 Smithery.ai 网址
  • 🔌 与 Cursor 编辑器无缝集成
  • 🚀 支持 MCP 协议
  • 💡 简单易用的命令行界面

安装

使用 npm 全局安装：

npm install -g @chengfeng2025/findmcp

系统要求

  • Node.js >= 16.0.0
  • npm >= 6.0.0

使用方法

安装完成后，您可以直接在命令行中使用 findmcp 命令：

# 查看帮助信息
findmcp --help

# 启动服务
findmcp

启动服务后，Cursor 编辑器将自动识别并连接到该服务，您可以在 Cursor 中使用 Smithery.ai 相关功能。

开发

如果您想要参与开发，可以克隆仓库并安装依赖：

# 克隆仓库
git clone https://github.com/Ceeon/findmcp.git

# 进入项目目录
cd findmcp

# 安装依赖
npm install

# 启动开发服务
npm run dev

依赖项

许可证

本项目采用 MIT 许可证。详情请参见 文件。

作者

  • Ceeon

问题反馈

如果您在使用过程中遇到任何问题，或有任何建议，欢迎：

  1. 提交 Issue
  2. 提交 Pull Request

更新日志

1.0.0

  • 🎉 首次发布
  • ✨ 实现基本的 Smithery.ai 网址查询功能
  • 🔌 支持 MCP 协议集成