# Forge Sense

> AI agent 的感知系统——时间、空间、天气。知道几点了、记住去过的地方、感受对话节奏

- **Type:** MCP server
- **Install:** `agentstack add mcp-linekforge-forge-sense`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [LinekForge](https://agentstack.voostack.com/s/linekforge)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [LinekForge](https://github.com/LinekForge)
- **Source:** https://github.com/LinekForge/forge-sense

## Install

```sh
agentstack add mcp-linekforge-forge-sense
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# forge-sense

Time and space awareness for AI agents — know the time, track your pace, sense the weather.

LLM agents are blind to time and environment. They can't tell how long they've been working, what time it is, or what's happening outside. forge-sense gives agents a watch, a compass, and a window.

## Modes

forge-sense runs in two modes:

| Mode | Entry | Use case |
|------|-------|----------|
| **CLI** | `forge-sense ` | Direct terminal use, low context cost |
| **MCP** | stdio server via `src/index.ts` | Claude Code MCP integration |

## Commands

| Command | What it does |
|---------|--------------|
| `now` | Current time, date, weekday |
| `elapsed` | How long this session has been alive |
| `mark ` | Set a named time marker |
| `since ` | Time elapsed since a marker |
| `markers` | List all active markers |
| `place save ` | Save a location bookmark |
| `place list` | List saved places |
| `place remove ` | Remove a saved place |
| `weather ` | Current weather (requires `AMAP_KEY`) |

## Quick Start

**Requires**: [Bun](https://bun.sh)

```bash
git clone https://github.com/LinekForge/forge-sense.git
cd forge-sense && bun install
```

### CLI mode (recommended)

```bash
# Symlink to PATH
ln -s "$(pwd)/src/cli.ts" ~/.local/bin/forge-sense

# Use
forge-sense now
forge-sense mark "start coding"
forge-sense since "start coding"
forge-sense weather 杭州    # requires AMAP_KEY
```

### MCP mode

```bash
claude mcp add --scope user forge-sense -- bun run /path/to/forge-sense/src/index.ts
```

## Environment Variables

| Variable | Required | Purpose |
|----------|----------|---------|
| `AMAP_KEY` | For `weather` only | Amap (高德) API key. Get one at [console.amap.com](https://console.amap.com/) |
| `FORGE_SENSE_PLACES` | No | Custom path for places.json (default: `~/.config/forge-sense/places.json`) |

## Place commands

```bash
forge-sense place save 家 --city 苏州 --note "home"
forge-sense place save 办公室 --city 上海 --coords "121.47,31.23"
forge-sense place list
forge-sense place remove 办公室
```

## Why

LLMs cannot estimate their own task duration — they don't know their inference speed, elapsed time, or token-to-second mapping. Giving agents time information can improve task completion rates significantly.

forge-sense lets agents actively perceive time and space, rather than guessing.

## Tech Stack

- Bun + TypeScript
- MCP SDK (`@modelcontextprotocol/sdk`) for MCP mode
- Amap API for weather (CLI mode only, opt-in)

## License

[MIT](LICENSE) — Linek & Forge

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [LinekForge](https://github.com/LinekForge)
- **Source:** [LinekForge/forge-sense](https://github.com/LinekForge/forge-sense)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-linekforge-forge-sense
- Seller: https://agentstack.voostack.com/s/linekforge
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.