Find-YJF

一个基于 MCP (Model Context Protocol) 的位置查询工具，用于获取杨建飞(Yang Jianfei)的最新位置信息。

MCP 服务配置

name: yjf-mcp
version: 0.1.0
description: 一个基于 MCP 的位置查询工具，用于获取杨建飞的最新位置信息
author: jianfei2024 <yangjianfei177@gmail.com>
license: MIT
homepage: https://pypi.org/project/find-yjf/
repository: https://github.com/jianfei2024/find-yjf
mcp:
  protocol_version: "1.0.0"
  transport: "stdio"
  package: "find-yjf"
  type: "python"
  tools:
    - name: get_user_latest_location
      description: 获取杨建飞用户的最新位置记录
      input_schema:
        type: object
        properties: {}
        required: []

功能特点

• 🌍 实时位置查询：获取最新的位置记录
• 📊 多格式支持：支持多种日期时间格式的解析和格式化
• 🔒 错误处理：完善的网络错误和异常处理机制
• 🚀 高性能：基于 FastMCP 框架，响应迅速

安装

环境要求

• Python 3.12 或更高版本
• uv 包管理器

安装步骤

1. 从 PyPI 安装

pip install find-yjf

1. 配置 MCP 服务器

在您的 MCP 客户端配置中添加以下服务器配置：

{
  "mcpServers": {
    "find-yjf": {
      "args": [
        "find-yjf@latest"
      ],
      "command": "uvx"
    }
  }
}

作为 MCP 工具使用

本项目实现了 MCP 协议，可以作为工具在各种支持 MCP 的环境中使用。

可用工具

• get_user_latest_location: 获取杨建飞用户的最新位置记录

使用示例

# 获取最新位置记录
result = get_user_latest_location()
print(result)

预期输出示例

{
  "success": true,
  "message": "查询成功",
  "data": [
    {
      "id": 1,
      "user_id": 1,
      "latitude": "39.9042",
      "longitude": "116.4074",
      "address": "北京市朝阳区",
      "recorded_at": "2023-11-15T14:30:00",
      "formatted_time": "2023-11-15 14:30:00"
    }
  ],
  "count": 1
}

API 参考

get_latest_locations

获取最新位置记录的底层函数。

参数:

• user_id (int, 可选): 用户ID，如果为None则查询所有用户
• limit (int): 返回记录数量限制，默认为3

返回值:

• 包含查询结果的字典，格式如下：

{
  "success": true,
  "message": "查询成功",
  "data": [
    {
      "id": 1,
      "user_id": 1,
      "latitude": "纬度值",
      "longitude": "经度值",
      "address": "地址信息",
      "recorded_at": "原始时间戳",
      "formatted_time": "格式化后的时间"
    }
  ],
  "count": 1
}

get_user_latest_location

获取杨建飞用户的最新位置记录的 MCP 工具。

参数:

• 无（内部已固定 user_id=1, limit=1）

返回值:

• JSON格式的位置信息字符串

开发

项目结构

find-yjf/
├── README.md
├── pyproject.toml
└── src/
    └── find-yjf/
        └── __init__.py

许可证

MIT License

作者

• jianfei2024 yangjianfei177@gmail.com

更新日志

v0.1.0

• 初始版本发布
• 实现基本的位置查询功能
• 集成 MCP 协议支持
• 发布到 PyPI

魔搭社区托管

本项目已发布到魔搭社区 MCP 服务市场，您可以直接在魔搭社区中使用此服务。

服务信息

• 服务名称: yjf-mcp
• 版本: 0.1.0
• 作者: jianfei2024
• 许可证: MIT

魔搭社区服务器配置

在魔搭社区中使用此MCP服务，请使用以下服务器配置：

{
  "mcpServers": {
    "yjf-mcp": {
      "args": [
        "find-yjf@latest"
      ],
      "command": "uvx"
    }
  }
}

更新服务

当您更新服务时，请确保：

1. 更新 pyproject.toml 中的版本号
2. 更新此 README.md 中的 MCP 服务配置部分
3. 发布新版本到 PyPI
4. 在魔搭社区中更新服务配置