ghstars
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GH_TOKEN | No | Alternative GitHub token environment variable used if GITHUB_TOKEN is not set. | |
| GITHUB_TOKEN | No | GitHub token used to access the GitHub API. Default token environment variable name is GITHUB_TOKEN; can also come from GH_TOKEN or `gh auth token`. | |
| GHSTARS_INDEX | No | Path to the SQLite index. Empty uses the default index.db in the config directory. Equivalent to [store] index. | |
| GHSTARS_STORE | No | Directory where ghstars stores the generated Markdown files. Equivalent to [store] dir in config.toml. | |
| GHSTARS_CONFIG | No | Path to the ghstars config.toml file. Overrides the default config location. | |
| OPENAI_API_KEY | No | Optional API key read by the default [llm] api_key_env setting when using an OpenAI-compatible LLM endpoint. | |
| GHSTARS_LLM_KEY | No | API key for the optional LLM endpoint. Equivalent to an API key set for [llm]. | |
| GHSTARS_LLM_BASE | No | Base URL of the optional LLM API used for Chinese scene tags and descriptions. Equivalent to [llm] base. | |
| GHSTARS_LLM_MODEL | No | Model name for the optional LLM endpoint. Equivalent to [llm] model. | |
| GHSTARS_GITHUB_USERNAME | No | GitHub username whose starred repositories should be synced. Equivalent to [github] username. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| stars_searchA | 检索本地已收藏的 GitHub 星标项目。 这是查「我 star 过什么」的首选工具：支持中文场景词（如「视频制作」「简历」）、 项目名、技术标签。返回项目名、分类、中文标签、描述、star 数、本地文件路径。 Args: query: 检索词，中英文均可。 limit: 返回条数上限。 category: 只在该分类内检索（如 ai-agents）。 include_archived: 是否包含已取消 star 的历史项目。 |
| stars_getA | 按仓库名查看单个已收藏项目的完整信息（owner/name，大小写不敏感）。 Args:
repo: 仓库全名，如 |
| stars_statsA | 查看星标库概况：总数、已归档数、各分类计数、索引位置。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 3 tools
The three tools target clearly distinct operations: fetch one starred repo's details, search the local star index, and show library statistics. Search returns summaries while get returns full per-repo information, so overlap is minimal and the roles are easy to distinguish.
All tool names use the same stars_ prefix with snake_case suffixes, giving a predictable resource/action pattern. Although stats is a noun rather than a verb, it is still consistent with the namespaced convention.
Three tools is a focused, well-scoped read-only surface for browsing a local starred-project index. Each tool earns its place: one for lookup, one for search, and one for overview statistics.
The core read operations are covered: search, single-repo detail, and aggregate stats. Minor gaps remain, such as explicitly listing all stars or categories and refreshing the local index from GitHub, but agents can work around most of these via search and stats.