Astron Bifrost - Claude Code Plugin

A Claude Code native plugin that connects to iFLYTEK Open Platform (讯飞开放平台) for AI model management, Coding Plan subscription management, and seamless integration with iFLYTEK's MaaS (Model-as-a-Service) platform.

English | 简体中文

Features

• 🔐 OAuth2 Authentication: Secure login to iFLYTEK Open Platform
• 📦 Coding Plan Management: View, switch, and manage your AI model subscriptions
• 📊 Usage Tracking: Real-time quota monitoring and usage statistics
• 🚀 One-Click Setup: Streamlined onboarding for new users
• 🌐 Bilingual Support: Commands available in English and Chinese
• 🔄 Model Switching: Easily switch between different AI models in your subscription

Installation

# Add marketplace
/plugin marketplace add iflytek/astron-bifrost

# Install plugin
/plugin install astron-bifrost@iflytek-astron

Quick Start

After installation, follow these steps:

1. Login to iFLYTEK Open Platform

   /astron-bifrost:login
   

   This will open your browser for OAuth2 authentication.

2. View Your Coding Plans

   /astron-bifrost:codingplan-list
   

3. Check Your Usage

   /astron-bifrost:codingplan-usage
   

4. Switch Models (if you have multiple models in your subscription)

   /astron-bifrost:codingplan-switch-model
   

Available Commands

Command	Description
/astron-bifrost:login	Login to iFLYTEK Open Platform
/astron-bifrost:logout	Logout and clear credentials
/astron-bifrost:setup	Initial setup guide for new users
/astron-bifrost:codingplan-list	List all your Coding Plan subscriptions
/astron-bifrost:codingplan-info	Show current active Coding Plan details
/astron-bifrost:codingplan-usage	View usage statistics and quota
/astron-bifrost:codingplan-apply	Apply a Coding Plan to current session
/astron-bifrost:codingplan-switch-model	Switch AI model within your plan
/astron-bifrost:codingplan-statusline	Show usage in terminal status line

Prerequisites

• Claude Code: Version 2.0.0 or higher
• Node.js: Version 18.0.0 or higher
• iFLYTEK Account: Register at maas.xfyun.cn
• Active Subscription: Purchase a Coding Plan at maas.xfyun.cn/packageSubscription

Configuration

The plugin automatically configures itself during installation. Configuration is stored in:

• MCP Server Config: ~/.claude/plugins/astron-bifrost/.mcp.json
• Credentials (encrypted): ~/.astron-bifrost/credentials.json

Troubleshooting

Login Issues

If login fails:

1. Check your network connection
2. Ensure you have registered at maas.xfyun.cn
3. Verify that port 51943 is not occupied (used for OAuth callback)
4. Try logout and login again: /astron-bifrost:logout → /astron-bifrost:login

No Subscriptions Found

If /astron-bifrost:codingplan-list shows no results:

1. Visit maas.xfyun.cn/packageSubscription
2. Purchase a Coding Plan subscription
3. Wait 1-2 minutes for activation
4. Run /astron-bifrost:codingplan-list again

Connection Errors

• Timeout errors: Check if maas.xfyun.cn is accessible from your network
• Certificate errors: Ensure your system time is correct
• Proxy issues: Configure proxy in environment variables if needed

How It Works

┌─────────────────┐
│  Claude Code    │
│  (Your IDE)     │
└────────┬────────┘
         │ MCP Protocol
         ▼
┌─────────────────┐
│  MCP Server     │ ← This Plugin (runs locally)
│  (Local)        │
└────────┬────────┘
         │ HTTPS
         ▼
┌─────────────────┐
│  iFLYTEK MaaS   │ ← Cloud Service
│  Platform       │
└─────────────────┘

The plugin runs as a local MCP server alongside Claude Code. It handles OAuth2 authentication and communicates with iFLYTEK's cloud platform over HTTPS to manage your Coding Plan subscriptions and model access.

Privacy & Security

• Local Credentials: All credentials are encrypted with AES-256-GCM and stored locally
• OAuth2 Flow: No password is ever stored; only access tokens are used
• HTTPS Only: All API communication uses TLS encryption
• Token Expiry: Access tokens expire after 2 hours and require re-authentication

Contributing

This is the compiled distribution package for the Astron Bifrost Claude Code plugin. For source code contributions or issues, please contact the maintainers.

License

MIT License - see LICENSE for details

Support

• Documentation: iFLYTEK Open Platform Docs
• Issues: Contact iFLYTEK support through the platform
• Community: Join discussions at maas.xfyun.cn

Changelog

See GitHub Releases for version history.

---

Maintained by: iFLYTEK Co., Ltd.
Platform: maas.xfyun.cn