房地产位置分析系统

利用Kakao Local API综合分析房地产位置的系统,提供Gradio Web应用和MCP服务器。

  • by hwain-ai
  • Python
  • 混合部署
  • 更新于
在 GitHub 查看 immortal0900/real-estate-location-analyzer

使用说明


title:房地产选址分析系统 颜色来源:蓝色 颜色To:绿色 sdk:毕业 sdk版本:5.49.1 app_file:app.py 固定:false 许可证:mit short_description:MCP 1岁生日派对的标签空间 标签:

  • 建设mcp轨道企业

房地产选址分析系统

利用Kakao本地API综合分析房地产选址的系统。 模型上下文协议(MCP)服务器哇 Gradio Web应用程序提供所有。

主要功能

分析项目

  • 教育环境:周边学校、学院信息
  • 交通条件:地铁站,公交车站
  • 便利条件:大型超市,医院
  • 自然环境:公园
  • 未来价值:重建信息

交付形式

  1. Gradio Web应用程序:用户友好的Web界面
  2. MCP服务器:AI代理可以使用的工具服务器

使用方法

1.使用Gradio Web应用程序

可以直接在Hugging Face Spaces上使用,也可以在本地运行。

本地运行

# 저장소 클론
git clone https://huggingface.co/spaces/MCP-1st-Birthday/real-estate-location-mcp
cd real-estate-location-mcp

# 가상환경 생성 및 의존성 설치 (uv 사용)
# uv가 없다면 먼저 설치: pip install uv
uv venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
uv pip install -r requirements.txt

# 환경 변수 설정
cp .env.example .env
# .env 파일에 KAKAO_REST_API_KEY 입력

# 실행
python app.py

2.使用MCP服务器

提供可用于AI代理(Claude Desktop、Cline等)的MCP服务器。

方法A:远程MCP端点(推荐)

无需单独安装,即可直接连接到Hugging Face Spaces上托管的MCP服务器。

claude_desktop_config.json 将以下内容添加到文件:

{
  "mcpServers": {
    "real-estate-analyzer": {
      "url": "https://immortal0900-real-estate-location-analyzer-mcp.hf.space/gradio_api/mcp/sse"
    }
  }
}

方法B:本地MCP服务器

# 서버 실행
python src/mcp_server.py

claude_desktop_config.json 将以下内容添加到文件:

{
  "mcpServers": {
    "real-estate-location": {
      "command": "python",
      "args": [
        "C:/real_estate_location_mcp/src/mcp_server.py"
      ],
      "env": {
        "KAKAO_REST_API_KEY": "your_kakao_api_key_here"
      }
    }
  }
}

API密钥发放

  1. Kakao Developers 连接
  2. 创建应用程序
  3. REST API密钥 复制
  4. .env 在文件中 KAKAO_REST_API_KEY 设置

项目结构

real_estate_location_mcp/
├── app.py                          # Hugging Face Spaces 메인 파일
├── requirements.txt                # Python 의존성
├── .env.example                    # 환경 변수 예시
├── README.md                       # 프로젝트 문서
├── src/
│   ├── __init__.py
│   ├── mcp_server.py              # MCP 서버
│   ├── gradio_app.py              # Gradio 웹 앱
│   └── tools/
│       ├── __init__.py
│       └── kakao_tool.py          # 카카오 API 도구
└── docs/
    ├── MCP_SETUP.md               # MCP 서버 설정 가이드
    └── GRADIO_DEPLOYMENT.md       # Gradio 배포 가이드

MCP工具

MCP服务器提供以下工具:

analyze_location

执行地址的综合位置分析。

参数:

  • address (str):要分析的地址
  • radius (int,optional):搜索半径(米,默认值:3000)

示例:

{
  "address": "서울시 강남구 역삼동",
  "radius": 5000
}

get_address_coordinates

将地址转换为纬度/经度坐标。

参数:

  • address (str):要转换的地址

示例:

{
  "address": "서울시 강남구 테헤란로 427"
}

部署

拥抱面部空间배포

  1. 拥抱面部空间 在中创建新空间
  2. 使用SDK 格拉迪奥 选择
  3. 将代码推送到存储库:
    git init
    git add .
    git commit -m "Initial commit"
    git remote add origin https://huggingface.co/spaces/YOUR_USERNAME/real-estate-location-mcp
    git push -u origin main
    
  4. 在Space Settings中 秘密 设置:
    • 姓名: KAKAO_REST_API_KEY
    • Value:Kakao API密钥

许可证

MIT许可证

感谢的话

这个项目 Kakao本地API使用。

咨询

如果您有任何问题或问题,请登录GitHub Issues。


采用Gradio和FastMCP制造