Hosted MCP

Подключите FreeAstroAPI напрямую к инструментам искусственного интеллекта через размещенный сервер MCP. Вам не нужно сначала устанавливать локальный сервер, запускать скрипт или что-либо собирать. Добавьте один URL-адрес, добавьте свой ключ API, повторно подключите свой инструмент искусственного интеллекта, и он сможет начать вызывать конечные точки астрологии в качестве инструментов.

Лучшее для пользователей AI-first: если ваше приложение предлагает «Удаленный MCP», «Hosted MCP» или «Потоковое HTTP MCP», выберите этот вариант. Если оно запрашивает у вас только команду терминала, это приложение вместо этого ожидает локальный сервер stdio.

URL-адрес сервера MCP

HTTPhttps://api.freeastroapi.com/mcp

1. Добавьте сервер

В своем приложении AI создайте новый удаленный сервер MCP и вставьте URL-адрес с этой страницы.

2. Добавьте свой ключ API.

Отправьте свой ключ как x-api-key заголовок. Сервер MCP использует тот же ключ и ограничения, что и обычный API.

3. Начните спрашивать

После подключения ваш ИИ сможет находить инструменты и вызывать их напрямую, вместо того, чтобы угадывать астрологические данные.

Быстрая настройка

Name: FreeAstroAPI
Type: Remote / Hosted MCP server
URL: https://api.freeastroapi.com/mcp

Header:
x-api-key: YOUR_API_KEY

Что получает ваш ИИ

Инструменты поиска и утилиты

  • Поиск города
  • Фаза Луны
  • Хронология фаз Луны
  • Эфемериды
  • Конечные точки ежедневного гороскопа

Инструменты диаграмм и астрологии

  • Расчет натальной карты
  • Транзиты
  • Западная синастрия
  • Конечные точки ведической карты
  • Китайские конечные точки BaZi

Конечные точки аутентификации, выставления счетов, администрирования, веб-перехватчиков и account-management намеренно исключены из MCP.

Хорошие подсказки, чтобы попробовать

Найдите Париж, Франция, и дайте мне точный часовой пояс и координаты.
Рассчитать натальную карту на 1 июня 1990 года на 14:30 по Нью-Йорку.
Покажите мне текущую фазу Луны и объясните ее простым языком.
Получите еженедельную таблицу эфемерид для Венеры и Марса в тропическом зодиаке.

Аутентификация

FieldValueNotes
Headerx-api-keyИспользуйте тот же ключ API, который вы уже используете для запросов REST.
Поведение уровнято же, что RESTMCP включен на каждый уровень, но звонки по-прежнему учитываются при обычном использовании и ограничениях количества запросов в секунду.
TransportПотоковое HTTPВыберите удаленный или размещенный вариант MCP в своем инструменте искусственного интеллекта.

Дополнительно: необработанные вызовы MCP

Большинству пользователей это никогда не понадобится. Здесь собраны расширенные инструменты, тестирование и отладка.

Initialize

curl -X POST "https://api.freeastroapi.com/mcp" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": {
        "name": "example-client",
        "version": "1.0.0"
      }
    }
  }'

Вызов инструмента

curl -X POST "https://api.freeastroapi.com/mcp" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "v2_geo_search",
      "arguments": {
        "q": "paris",
        "limit": 3
      }
    }
  }'

Пример ответа

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"results\": [ ... ],\n  \"count\": 3\n}"
      }
    ],
    "structuredContent": {
      "results": [
        {
          "name": "Paris",
          "country": "FR",
          "lat": 48.85341,
          "lng": 2.3488,
          "timezone": "Europe/Paris",
          "population": 2138551
        }
      ],
      "count": 1
    },
    "metadata": {
      "status_code": 200,
      "path": "/api/v2/geo/search",
      "method": "GET"
    }
  }
}

Поиск неисправностей

Я вижу только настройку «команды», а не настройку URL. Это приложение ожидает локальный сервер stdio MCP. Используйте приложение, поддерживающее удаленный или размещенный MCP.

Сервер подключается, но инструменты не работают. Убедитесь, что ваш ключ API действителен и срок его действия не истек. MCP использует тот же ключ и ограничения, что и обычный API.

Мой ИИ говорит, что ставка ограничена. Вызовы MCP учитываются точно так же, как прямые запросы API. Проверять Ограничения ставок.

Сначала мне нужны координаты. Попросите ИИ использовать поиск по городу, прежде чем запрашивать натальную, транзитную или синастрическую карту. ИИ может сделать это автоматически через MCP.

Связанные документы